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About This 
Guide 



This reference guide provides information to help you: 

■ Use the command line interface. 

■ Obtain information about specific commands when needed. 
This chapter includes the following topics: 

■ Overview, page 10 

■ Conventions, page 1 1 

■ Rack Stability, page 14 

■ Getting Help, page 15 
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About this Guide 



Overview 

This section covers the following topics: 

■ Intended Audience 

■ Related Documentation 

Intended Audience 

This book is intended for use by data center administrators, system administrators, 
and customer support personnel who are experienced with the following: 

■ Concepts of networking, storage area network, and zoning. 

■ HP products included in the user's network. 

■ Establishing and using a Telnet session. 

■ Using a terminal command line. 

Related Documentation 

For a list of corresponding documentation, see the Related Documents section of 
the Release Notes that came with this product. 

For the latest information, documentation, and firmware releases, please visit the 
following StorageWorks website: 

http://hl 8006. wwwl .hp.com/storage/saninfrastructure.html 

For information about Fibre Channel Standards, visit the Fibre Channel Industry 
Association website, located at http:/ / www.fibrechannel.org . 
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Conventions 

Conventions consist of the following: 

■ Document Conventions 

■ Text Symbols 

■ Equipment Symbols 

Document Conventions 

The document conventions included in Table 1 apply in most cases. 
Table 1 : Document Conventions 



Convention 


Element 


Blue text: Figure 1 


Cross-reference links 


Bold 


Menu items, buttons, and key, tab, and 
box names 


Italics 


Text emphasis and document titles in 
body text 


Monospace font 


User input, commands, code, file and 
directory names, and system responses 
(output and messages) 


Monospace, italic font 


Command-line and code variables 


Blue underlined sans serif font text 

(http://www.hp.com) 


Web site addresses 



Text Symbols 

The following symbols may be found in the text of this guide. They have the 
following meanings: 



WARNING: Text set off in this manner indicates that failure to follow 
/ J \ directions in the warning could result in bodily harm or death. 
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Caution: Text set off in this manner indicates that failure to follow directions 
could result in damage to equipment or data. 



Tip: Text in a tip provides additional help to readers by providing nonessential or 
optional techniques, procedures, or shortcuts. 



Note: Text set off in this manner presents commentary, sidelights, or interesting points 
of information. 



Equipment Symbols 



The following equipment symbols may be found on hardware for which this guide 
pertains. They have the following meanings. 



t\ //\ enc ' osec ' surface or area of the equipment marked with these 

!\/7\ symbols indicates the presence of electrical shock hazards. Enclosed 
area contains no operator serviceable parts. 

WARNING: To reduce the risk of personal injury from electrical shock 
hazards, do not open this enclosure. 



•\ Any RJ-45 receptacle marked with these symbols indicates a network 

I \VJW interface connection. 

WARNING: To reduce the risk of electrical shock, fire, or damage to 
the equipment, do not plug telephone or telecommunications 
connectors into this receptacle. 
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Any surface or area of the equipment marked with these symbols 
'm\ indicates the presence of a hot surface or hot component. Contact with 
this surface could result in injury. 

WARNING: To reduce the risk of personal injury from a hot 
component, allow the surface to cool before touching. 



Power supplies or systems marked with these symbols indicate 
the presence of multiple sources of power. 

WARNING: To reduce the risk of personal injury from electrical 
shock, remove all power cords to completely disconnect power 
from the power supplies and systems. 



Any product or assembly marked with these symbols indicates that the 
component exceeds the recommended weight for one individual to 
handle safely. 

WARNING: To reduce the risk of personal injury or damage to the 
equipment, observe local occupational health and safety requirements 
and guidelines for manually handling material. 
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Rack Stability 

Rack stability protects personnel and equipment. 



A, WARNING: To reduce the risk of personal injury or damage to the 
/ I \ equipment, be sure that: 

■ The leveling jacks are extended to the floor. 

■ The full weight of the rack rests on the leveling jacks. 

■ In single rack installations, the stabilizing feet are attached to the rack. 

■ In multiple rack installations, the racks are coupled. 

■ Only one rack component is extended at any time. A rack may become 
unstable if more than one rack component is extended for any reason. 
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Getting Help 

If you still have a question after reading this guide, contact an HP authorized 
service provider or access our website: http:/ /www. hp. com . 

HP Technical Support 

In North America, call technical support at 1-800-652-6672, available 24 hours a 
day, 7 days a week. 



Note: For continuous quality improvement, calls may be recorded or monitored. 



Outside North America, call technical support at the nearest location. Telephone 
numbers for worldwide technical support are listed on the HP website under 
support: http:/ / www.hp.com/ country/ us/ eng/ support.html . 

Be sure to have the following information available before calling: 

■ Technical support registration number (if applicable) 

■ Product serial numbers 

■ Product model names and numbers 

■ Applicable error messages 

■ Operating system type and revision level 

■ Detailed, specific questions 

HP Storage Website 

The HP website has the latest information on this product, as well as the latest 
drivers. Access storage at: http:/ / www.hp.com/ country/ us/ eng/ prodserv/ 
storage.html . From this website, select the appropriate product or solution. 

HP Authorized Reseller 

For the name of your nearest HP authorized reseller: 

■ In the United States, call 1-800-345-1518. 

■ In Canada, call 1-800-263-5868. 
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■ Elsewhere, see the HP website for locations and telephone numbers: 

http://www.hp.com . 
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Introduction 



This chapter introduces the command line interface (CLI) and describes the 
essentials for using CLI commands. It includes the following topics: 

■ Command Line Interface Overview, page 18 

■ Entering Command Line Interface Commands, page 19 

■ Logging In and Logging Out, page 29 

■ Handling Command Line Interface Errors, page 34 

■ Using the Command Line Interface Help, page 35 

■ Adding Comments to Scripts, page 36 

■ Telnet Session, page 37 
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Command Line Interface Overview 

The Command Line Interface (CLI) is a feature that provides an alternative to the 
HP High Availability Fabric Manger (HAFM) and Embedded Web Server (EWS) 
interface products for director and switch management capabilities. 

The CLI can only be used through a Telnet client session in an out-of-band 
management environment, using the Ethernet port in the director or edge switch. 
Although the primary use of the CLI is in host-based scripting environments, the 
CLI commands can also be entered directly at a command line. Any hardware 
platform that supports the Telnet client software can be used. 

The purpose of the CLI is to automate management of a large number of directors 
and edge switches through scripts. Although the primary use of the CLI is in 
host-based scripting environments, CLI commands can also be entered directly at 
a command line. 

Because the CLI is not an interactive interface, no prompts are displayed to guide 
the user through a task. If an interactive interface is needed, the HAFM application 
or EWS application should be used instead of the CLI. 



18 



CLI Reference Guide for Directors and Edge Switches 



Entering Command Line Interface Commands 

CLI commands can be entered directly at the command line of a workstation or 
coded in a script. CLI commands are not case sensitive. 

Documentation Conventions 

Throughout this publication, periods are used to separate components of a 
command name. However, periods cannot be included when the command is 
actually entered at a workstation or coded in a script. How to enter commands is 
explained in "Navigation of the CLI Command Tree" on page 26. Even though 
commands cannot be entered with periods, command line prompts do include 
periods as shown below: 

Conf ig . Port> 

Navigation Conventions 

Basic command line navigation conventions are supported. The following table 
includes asynchronous commands recognized by the CLI. 



Table 2: CLI Command Tree Navigation Conventions 



Character 
Sequence 


Common 
Name 


Action or Description 


<CR> 


Carriage 
Return 


Pass a completed line to the parser. 


<DEL> 


Delete 


Backspace one character and delete the 
character. 


<NL> 


New Line 


Pass a completed line to the parser. 


<SP> 


Space 


Used to separate keywords. 


# 


Pound Sign 


Used to designate comments in a script. 


2 


Question Mark 


Provide help information. 


II 


Quotation 
Mark 


Used to surround a single token. 


A A 


Control-A 


Position the cursor to the start of the line. 


A B 


Control-B 


Position the cursor left one character. 


A D 


Control-D 


Delete the current character. 


A E 


Control-E 


Position the cursor to the end of the line. 
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Table 2: CLI Command Tree Navigation Conventions (Continued) 



Character 
Sequence 


Common 
Name 


Action or Description 


AC 

r 


^onir 01 r 


rosiTion Tne cursor ngriT one cnaracTer. 


n 


Cr\r\krr\\ \A 


DacKspace one cnaracTer ana aeiere rne 
character. 


a i 


Tab 


Complete the current keyword. 


A K 


Control-K 


Delete to the end of the line. 


A L 


Control-L 


Redraw the line. 


A N 


Control-N 


Move down one line in the command history. 


A P 


Control-P 


Move up one line in the command history. 


A R 


Control-R 


Redraw the line. 


A U 


Control-U 


Clear the input and reset the line buffer. 


A X 


Control-X 


Clear the input and reset the line buffer. 


<ESC>[A 


Up Arrow 


Move up one line in the command history. 


<ESC>[B 


Down Arrow 


Move down one line in the command history. 


<ESC>[C 


Right Arrow 


Position the cursor right one character. 


<ESC>[D 


Left Arrow 


Position the cursor left one character. 



Command Tree 

The command tree of the CLI begins from the root. The commands in the four 
extended branches (conf ig, maint, perf , and show) are described in "CLI 
Commands" on page 39. 

There are three additional commands (login, logout, and commaDelim) that 
are globally available. These commands are described in this chapter. The 
hierarchy from the root, reading from left to right, is listed in Table 3 

Table 3: CLI Command Tree 



config 


enterpriseFabMode 


setState 






features 


install Key 








enterpriseFa bMode 








ficonms 








OpenSysMS 
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Table 3: CLI Command Tree (Continued) 







openTrunking 








show 






ficonMS 


setState 






ID 

r 


ethernet 








show 






port 


blocked 








extDist 








fan 








name 








show 








speed 








type 






openSysMS 


setState 






security 


fabricBinding 


activatePending 








addAttachedMem 
bers 








addMember 








clea rMemList 








deactivateFabBind 








deleteMember 








replacePending 








showActive 








showPending 






portBinding 


bound 








wwn 








show 






switch Binding 


addMember 








deleteMember 








setState 








show 
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Table 3: CLI Command Tree (Continued) 







userRights 


administrator 








operator 








show 




snmp 


add Community 








authTra ps 








deleteComm unity 








SetFaMibVersion 








setState 








show 






switch 


bbCredit 








domainRSCN 








edTOV 








insistDomainld 








interopMode 








ItdFabRSCN 








prefDomainld 








priority 








raTOV 








reroute Delay 








speed 








show 








zoningRSCN 






system 


contact 








date 








description 








location 








name 








show 






zoning 


setDefZoneState 








activateZoneSet 
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Table 3: CLI Command Tree (Continued) 







deactivateZoneSet 








replaceZoneSet 








clearZoneSet 








addZone 








deleteZone 








renameZoneSet 








addWwnMem 








addPortMem 








clearZone 








delete WwnMem 








deletePortMem 








renameZone 








showPending 








show Active 




maint 


port 


beacon 








reset 






system 


beacon 








clearSysError 








ipl 








resetConfig 








setOnlineState 




perf 


class2 








class3 








clearStats 








errors 








link 








openTrunking 


backPressure 








congestionThresh 








LowBBCreditThresh 








setState 
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Table 3: CLI Command Tree (Continued) 







show 








unresCongestion 






preferred Path 


clearPath 








setPath 








setState 








showPath 






thresholdAlerts 


counter 


addAlert 








addPort 








removePort 








setCounter 








setParams 








show 








showStatisticTable 






deleteAlert 








setState 








throughput 


addAlert 








addPort 








removePort 








setUtilType 








setUtilPercentage 








setParams 








show 








showUtilTypeTable 




traffic 






show 


all 








eventLog 








fabric 


nodes 








topology 
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Table 3: CLI Command Tree (Continued) 





features 








frus 








ip 


ethernet 






linklncidentLog 








loginServer 








nameServer 








nameServerExt 








openTrunking 


config 








reroutelog 






port 


config 








exit 








info 








nodes 








status 








technology 






preferred Path 


showPath 






security 


fabricBinding 








portBinding 








switchBinding 






switch 








system 








thresholdAlerts 


alerts 








log 






zoning 







Commands are shown, with the exception of the zoning commands, in 
alphabetical order to make them easier to locate. Although the commands can be 
entered in any order, depending on the results desired, the order shown in Table 3 
for the zoning commands is a typical order in which the zoning commands are 
entered. 
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Note that the order in which commands are entered determines the order in which 
the show commands display the values. Refer to "CLI Commands" on page 39 
for examples of show commands output. 

Navigation of the CLI Command Tree 

Once the administrator or operator logs in and receives the Root> prompt, the 
CLI commands are accessed by navigating up and down the CLI command tree. 

To move from the root through the any of the four extended branches, enter the 
name of the next branch as shown in Table 3. For example, to use the 
conf ig . port . name command to configure the name for port 4 on the edge 
switch, this series of commands is entered: 

Root> config 
Config> port 

Config. Port> name 4 "HP Tape Drive" 

At this point, to enter the maint . port . beacon command to set the beaconing 
state of port 4, the following series of commands is entered: 

Config . Port> . . 
Conf ig> . . 
Root> maint 
Maint> port 

Maint. Port> beacon 4 true 



Note: You must return all the way to the root of the tree to transition to another 
extended branch. When traversing back to the root, the name of each branch cannot 
be used. Instead use the double-dot command (two periods) to move back towards the 
root. Only one double-dot command may be entered at a time. 
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One approach to making the navigation more concise is to use the root 
command to jump directly to the root of the CLI command tree. The previous 
example, which shows stepping back to the root with the double-dot command, is 
simplified as follows: 

Conf ig . Port> root 
Root> maint 
Maint> port 

Maint. Port> beacon 4 true 

Another approach to making the navigation more concise is to use the complete 
command syntax from the Root> prompt each time. For example, to issue the 
conf ig . port . name command and then the maint . port . beacon 
command, the commands are entered as follows: 

Root> config port name 4 "HP Tape Drive" 

Root> maint port beacon 4 true 

As shown in this example, use of the complete command syntax avoids navigating 
up and down the branches of the CLI command tree, and the prompt stays at the 
root. The use of complete command syntax is particularly useful when writing 
scripts. 

When coding a script, remember to code the appropriate character sequences, 
which are described in "Navigation Conventions" on page 19. 

Root> config port name 4 "HP Tape Drive"<CR> 
Root> maint port beacon 4 true<CR> 

Limitation on Movements 

As the commands are entered, they are recorded in a history log. The limitations 
on movement that result from use of the history log are: 

■ If a command has more than 60 characters, the command runs, but the 

command is not recorded in the history log, and the position in the tree does 
not change, as shown in the following example. Because the command is not 
recorded in the history, a subsequent asynchronous command (navigation 
command) cannot depend on it. 

Root> config zoning addWwnMem TheUltimateZone 
10:00:00:00:C9:22:9B:64 

Root> 
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■ Whenever the position in the CLI command tree moves to a new branch (for 
example, conf ig to maint, conf ig to conf ig . port, or 
conf ig . port to conf ig), the history log is cleared. In this case, any 
asynchronous commands (for example, the up-arrow command <ESC> [A or 
the up-arrow keyboard symbol) cannot move the position back towards the 
root, as shown in this example: 

Root> config 

Root. Conf ig> port 

Root. Conf ig.Port> <ESC> [A 

Root . Config . Port> 

Parameters 

Some command parameters accept character strings that include spaces. 
Quotation marks are required when a string includes spaces. 

Conf ig . System> location Building_2 4_Room_16 

Conf ig . System> location "Building 24 Room 16" 

If spaces are not included in a parameter that accepts a string, the quotation marks 
are not required around that string. 

To include quotation marks in a string, use the escape character (\) before the 
quotation marks. 

Conf ig . System> location "Building 24 VHP Lab\ " " 

A null string can be created by using the quotation marks without any space 
between them. 

Conf ig . System> location "" 

Output 

All output from the CLI commands is limited to the standard 80 columns 
supported by most Telnet interfaces. The output is left-justified. 
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Logging In and Logging Out 

The CLI allows a single Telnet client to be connected to a director or edge switch. 
If a Telnet client logs out, or if after 15 minutes of inactivity the client's access 
times out, another Telnet client may log in. Also note that the Telnet client (user) 
must log in any time a director or edge switch is restarted because the current 
user's access is lost. Examples of a restart include an IPL and any power-off 
situation. 

User Access Rights 

The CLI supports two user access rights: administrator and operator. A user who 
logs in with administrator access rights can use all of the commands described in 
this publication. However, operator access rights grant permission to use only the 
perf and show branches of the CLI command tree (for example, the 
perf . traffic and show, system commands), as well as the globally 
available commands (login, logout, and commaDelim) described in the 
following section. 
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login 



Syntax 

login 

Purpose 

This command allows a Telnet client to connect to a director or edge switch. 

Description 

This command allows the user to log in with either administrator or operator 
access rights. The default password is password. The login command is called 
automatically by the CLI each time a new Telnet session is activated, as well as 
each time new administrator access rights are configured. 

After the login command is issued, the Username : prompt automatically 
displays. After a valid user name is entered, the Password : prompt 
automatically displays. After the corresponding valid password is entered, the 
Root> prompt displays. At this prompt the user may enter any of the commands 
included in Table 3. 

A user name and password can be set by the administrator through the 

conf ig . security . userRights . administrator command or through 

the conf ig . security . userRights . operator command. 

The access rights chosen for the CLI are completely independent of the other 
product interfaces, for example, SNMP or Hewlett-Packard (HP) product 
interfaces. 

Parameters 

This command has no parameters. 
Command Examples 

login 

Username: Administrator 
Password: password 

login 

Username : Operator 
Password: password 
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logout 

Syntax 

logout 

Purpose 

This command allows a Telnet client to disconnect from a director or edge switch. 

Description 

This command logs out the single Telnet client connected to a director or edge 
switch. This command can be entered at any point in the command tree. 

Parameters 

This command has no parameters. 
Command Examples 

Root> logout 
Config> logout 
Config.Port> logout 
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commaDelim 



Note: The output examples shown in the other sections of this publication presume 
that commaDelim is off. 



Syntax 

commaDelim enable 

Purpose 

This command enables the user to obtain displayed information (from a show 
command) in comma-delimited, rather than tabular, format. The default format is 
tabular. 

Description 

This command can be entered at any point in the command tree. 

Parameter 

This command has one parameter: 

enable 

Specifies the comma-delineated state for output. Valid values are true and false. 
Boolean 1 and 0 may be substituted as values. 

Command Examples 

Root> commaDelim true 

Config> commaDelim 1 

Conf ig . Port> commaDelim false 

Output Example 

Output displayed in commaDelim mode follows. 

Root> show eventLog 

Date/Time, Code, Severity, FRU, Event Data, 

04/12/01 10 : 58A, 375, Major, CTP-0, 00010203 04050607 08090A0B 
0C0D0E0F, 
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04/12/01 10 : 58A, 375, Major, CTP-0, 00010203 04050607 08090A0B 
0C0D0E0F, 

04/12/01 9:58A, 385, Severe, CTP-0, 00010203 04050607 08090A0B 
0C0D0E0F, 

04/11/01 7 : 18P, 395, Severe, CTP-0, 00010203 04050607 08090A0B 
0C0D0E0F, 
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Handling Command Line Interface Errors 

Two types of errors detected by the CLI are: 

■ An error associated with the interface. For example, a keyword is misspelled 
or does not exist. 

Root> confg 

Error 234: Invalid Command 

■ An error associated with a fabric, director, or edge switch. For example, a 
parameter error is detected by a switch, where port 24 is entered for a switch 
that supports only 16 ports. 

Root> config port name 24 "Port 24" 

Error 248: Invalid Port Number 

In either case, the command is ignored. The CLI remains at the point it was before 
the command was entered. The error messages, including error number and error, 
are listed in "Error Messages" on page 269. 
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Using the Command Line Interface Help 



The question mark (?) can be used within a command to obtain certain 
information: 

■ If the question mark is used in place of a command keyword, all the keywords 
at that level of the CLI command tree display. 

Root> config system ? 

Command identified 

contact - Set the system contact attribute 

date - Set the system date and time 

description - Set the system description attribute 

location - Set the system location attribute 

name - Set the system name attribute 

show - Display the system configuration 

■ If the question mark is used at the end of a recognized command, any 
parameters for that command display. 

Root> config port name ? 

- name <portNumber> <portName> 

■ If the question mark is used after one or more characters of a keyword, any 
keywords at that level of the CLI command tree display. 

Root> config s? 

security snmp switch system 
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Adding Comments to Scripts 

The pound sign (#) can be used to add comments in a script file. The pound sign 
must be the first character in the line; the CLI ignores everything after the pound 
sign in that line. The following lines are valid: 

Root> #Change port 3 to an E_Port<CR> 

Root> config port<CR> 

config.port> ##################<CR> 

config. port> ## Begin Script ##<CR> 

config. port> ##################<CR> 

The pound sign cannot be used after any other characters (a command, for 
example) to start a comment. The following is an invalid script line: 

Root> maint system beacon true # Turn on beaconing<CR> 

To correct the previous script line, move the comment either before or after the 
line with the command. For example, the following examples are both valid: 

Root> # Turn on beaconing<CR> 

Root> maint system beacon true<CR> 

or 

Root> maint system beacon true<CR> 
Root> # Turn on beaconing<CR> 



Note: Comments of over 200 characters in length may cause unpredictable system 
behavior. Limit comments to 200 characters per line. 
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Telnet Session 

The CLI can only be used through a Telnet client session in an out-of-band 
management environment, using the Ethernet port in a director or edge switch. 
Although the primary use of the CLI is in host-based scripting environments, the 
CLI commands can also be entered directly at a command line. Any hardware 
platform that supports the Telnet client software can be used. 



Note: If you have the HAFM application, use the Configure option in the software to 
enable Telnet access before attempting to establish a Telnet client session. You can 
also enable Telnet access by using the Configure option of the Embedded Web Server 
(EWS). Telnet access is enabled by default. Any changes to the enabled state of the 
Telnet server are retained through system resets and power cycles. 

Ethernet Connection Loss 

If the Ethernet cable is disconnected from a director or edge switch during a 
Telnet session, one of three scenarios is possible: 

■ Replace the Ethernet cable before the client connection times out, and the 
Telnet session will continue. 

■ Wait 15 minutes for the client connection times out; then replace the Ethernet 
cable and restart the connection. 

■ If the client connection has already timed out, replace the Ethernet cable. 
Open an EWS or HAFM application window. Toggle the enabled state of the 
CLI, thereby clearing the client connection. Restart the client connection. 

Once the client connection is reestablished, verify your configuration's 
completeness and accuracy. 
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CLI Commands 



This chapter describes command line interface (CLI) commands, including their 
syntax, purpose, and parameters, as well as examples of their usage and any 
output that they generate. It includes the following topics: 

■ Command Overview, page 40 

■ config Commands, page 41 

■ maint Commands, page 144 

■ perf Commands, page 152 

■ show Commands, page 207 
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Command Overview 

Most of the commands in this chapter are listed in alphabetical order to make 
them easy to locate. Although the commands can be entered in any order, 
depending on the results desired (so long as the tree structure is followed), the 
order used herein for the zoning commands follows a typical order of entry. The 
various show commands are usually entered at the end of a group of other 
commands. 
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The config branch of the CLI command tree contains commands that set 
parameter values. These values are not temporary (session) values, but are 
retained across power cycles. The commands in the config branch can by used 
only by the administrator. 

Note that the config . zoning commands function in a different way from the 
other CLI commands, which are single action commands that take effect 
immediately. A zoning configuration is typically too complicated to be described 
by a single command, so the first zoning command entered invokes a work-area 
editor. The commands take effect on a temporary copy of a zone set in the work 
area until the temporary copy in the work area is activated to the fabric or is 
discarded. 

Because not all the verification of the zone set can occur on the temporary copy in 
the work area, it is possible, however unlikely, that the copy of the zone set 
encounters no errors until the zone set is activated to the fabric. 

In general, the config naming commands (except for the config . zoning 
commands) use the USASCII character set. All of the characters in this 
128-character set (the first 7-bit subset of the ISO-8859-1 Latin- 1 character set) 
are valid. Any exceptions are noted in the specific command descriptions. 
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config.enterpriseFabMode.setState 



Syntax 

setState enterpriseFabModeState 

Purpose 

This command sets the Enterprise Fabric Mode state for the fabric. The 
SANtegrity feature key must be installed to activate the Enteiprise Fabric Mode 
state. 

Parameters 

This command has one parameter: 

enterpriseFabModeState Specifies whether enterpriseFabMode is 

active. Valid values are activate and 
deactivate. Boolean 1 and 0 may be 
substituted as values. 

Command Example 

Root> config enterpriseFabMode setState 1 



Note: The command "config. features. enterpriseFabMode" on page 43 has 
functionality that is identical to this command. 
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config.features.enterpriseFabMode 



Syntax 

enterpriseFabMode enterpriseFabModeState 

Purpose 

This command sets the Enterprise Fabric mode state for the fabric. The 
SANtegrity feature key must be installed to activate the Enterprise Fabric mode 
state. 

Parameters 

This command has one parameter: 

enterpriseFabModeState Specifies whether enterpriseFabMode is 

active. Valid values are activate and 
deactivate. Boolean 1 and 0 may be 
substituted as values. 

Command Example 

Root> config features enterpriseFabMode 1 



Note: The command "config. enterpriseFabMode. setState" on page 42 has 
functionality that is identical to this command. 
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config.features.ficonms 



Syntax 

ficonms ficonmsState 

Purpose 

This command sets the enabled state of the FICON Management Server. The 
FICON Management Server feature key must be installed in order to enable the 
FICON Management Server State. (The Edge Switch 2/24 does not accept this 
command.) 



Note: If the FICON Management Server is enabled, the default management style is 
the FICON management style. The Open Systems management style cannot be used. 



Parameters 

This command has one parameter: 

ficonmsState Specifies whether the FICON Management 

Server is enabled. Valid values are enable 
and di sabl e. Boolean 1 and 0 may be 
substituted as values. 

Command Example 

Root> config features ficonms 1 



Note: The command "config. ficonms. setState" on page 50 has functionality that is 
identical to this command. 
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config.features.installKey 



Syntax 

installKey featureKey 

Purpose 

This command allows the user to install a feature set that is enabled by the 
provided feature key. The switch can be either offline or online when the 
command is executed. 



Note: If any currently installed features are being removed by the new feature key, the 
switch must be offline when the command is given. 



Parameters 

This command has one parameter: 

featureKey Specifies the key you have received to enable an 

optional software feature on a specific product. A 
feature key is a string of case-sensitive, 
alphanumeric ASCII characters. 

The number of characters may vary in the format; 
however, the key must be entered exactly, 
including the hyphens. An example of a feature key 
format is XxXx-XXxX-xxXX-xX. 

Command Example 

Root> config features installKey AaBb-CCdD-eeFF-gH 
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config.features.OpenSysMS 



Syntax 

OpenSysMS osmsState 

Purpose 

This command sets the enabled state of the Open Systems Management Server. 
The Open Systems Management Server feature key must be installed in order to 
enable the OSMS State. 

Parameters 

This command has one parameter: 

osmsState Specifies whether the Open Systems 

Management Server is enabled. Valid values 
are enabl e and di sabl e. Boolean 1 and 0 
may be substituted as values. 

Command Example 

Root> config features OpenSysMS 1 



Note: The command "config. openSysMS.setState" on page 53 has functionality that 
is identical to this command. 
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conf ig .f eatu res .opentru nki ng 



Syntax 

opentrunking openTrunkingState 

Purpose 

This command sets the enabled state of the OpenTrunking feature. The 
OpenTrunking feature key must be installed in order to enable open trunking. 

Parameters 

This command has one parameter: 

openTrunkingState This parameter can be set to enabl e or 

di sabl e the OpenTrunking feature. Boolean 
1 and 0 may be substituted as values. 

Command Example 

Root> config features opentrunking 1 



Note: The command "perf. opentrunking. setState" on page 165 has functionality that 
is identical to this command. 
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config.features.show 



Syntax 
Purpose 



show 



Parameters 



This command shows the product feature information configured for this switch. 
This command provides the same output as the command "show. features" on 
page 215. 



This command has no parameters. 



Command Example 

Root> config features show 

Output 

The product feature data is displayed as a table that includes the following 
properties: 

Installed Feature The feature set installed using a feature key. 
Set Only installed keys are displayed. 

Feature Individual features within each set. In many 

cases, there is only one feature within each 
feature set. 

State The state of the individual feature. Fabric-wide 

features are displayed as Active/Inactive, 
switch-centric features are displayed as 
Enabled/Disabled. 

Output Example 

The output from the config . features . show command displays as follows: 

Installed Feature Set Feature State 

Open Systems Management Server OSMS Enabled 
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Flex Ports 
SANtegrity 
SANtegrity 
SANtegrity 
Open Trunking 



8 Flex Ports Enabled 
Fabric Binding Active 
Switch Binding Enabled 
Enterprise Fabrics Active 
Open Trunking Enabled 
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config.ficonms.setState 



Syntax 

setState ficonmsState 

Purpose 

This command sets the enabled state of the FICON Management Server. The 
FICON Management Server feature key must be installed in order to enable the 
FICON Management Server State. (The Edge Switch 2/24 does not accept this 
command.) 



Note: If the FICON Management Server is enabled, the default management style is 
the FICON management style. The Open Systems management style cannot be used. 



Parameters 

This command has one parameter: 

ficonmsState Specifies whether the FICON Management 
Server is enabled. Valid values are enabl e 
and disable. Boolean 1 and 0 may be 
substituted as values. 

Command Example 

Root> config ficonms setState 1 



Note: The command "config. features. ficonms" on page 44 has functionality that is 
identical to this command. 
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config.ip.ethernet 



Syntax 

ethernet ipAddress gatewayAddress subnetMask 

Purpose 

This command sets the Ethernet network settings. 

Description 

The Telnet connection can be lost when these Ethernet network settings are 
changed. 

If the IP address is reconfigured, your Telnet client must be reconnected to the 
new IP address. A new login will be requested. 

Parameters 

This command has three parameters: 

ipAddress Specifies the new IP address for the director or 

edge switch. The address must be entered in 
dotted decimal format (for example, 10.0.0.0). 

gatewayAddress Specifies the new gateway address for the 

Ethernet interface. The address must be entered 
in dotted decimal format (for example, 
0.0.0.0). 

subnetMask Specifies the new subnet mask for the Ethernet 

interface. The address must be entered in 
dotted decimal format (for example, 
255.0.0.0). 

Command Example 

Root> config ip ethernet 10.0.0.0 0.0.0.0 255.0.0.0 
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config.ip.show 

Syntax 

show 

Purpose 

This command shows the LAN configuration. 

Parameters 

This command has no parameters. 
Command Example 

Root> config ip show 

Output 

The LAN configuration data is displayed as a table that includes the following 
properties: 

IP Address The IP address. 

Gateway Address The gateway address. 

Subnet Mask The subnet mask. 

Output Example 

The output from the config . ip . show command displays as follows: 

IP Address : 10 . 0 . 0 . 0 

Gateway Address: 0.0.0.0 
Subnet Mask: 255.0.0.0 
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config.openSysMS.setState 



Syntax 

setState osmsState 

Purpose 

This command sets the enabled state of the Open Systems Management Server. 
The Open Systems Management Server feature key must be installed in order to 
enable the OSMS State. 

Parameters 

This command has one parameter: 

osmsState Specifies whether the Open Systems 

Management Server is enabled. Valid values 
are enabl e and di sabl e. Boolean 1 and 0 
may be substituted as values. 

Command Example 

Root> config OpenSysMS setState 1 



Note: The command "config. features. OpenSysMS" on page 46 has functionality that 
is identical to this command. 
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conf ig .port, blocked 



Syntax 

Purpose 

Parameters 



blocked portNumber blockedState 



This command sets the blocked state for a port. 



This command has two required parameters: 



portNumber 



blockedState 



Specifies the port number. Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 

Specifies the blocked state for the port. Valid 
values are true and false. 

Boolean 1 and 0 may be substituted as values. 



Command Examples 



Root> config port blocked 4 false 
Root> config port blocked 4 0 
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config.port.extDist 



Syntax 
Purpose 

Description 



Parameters 



extDist portNumber extDistOn 



This command sets the extended distance state for a port. (The Edge Switch 2/24 
does not accept this command.) 



When the extended distance field is true, the port is configured for 60 buffer 
credits, which supports a distance of up to 100 km for a 1 gigabit per second 
(Gbps) port. 



This command has two required parameters: 

portNumber Specifies the port number. Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 

extDistOn Specifies the extended distance state for the 

port. Valid values are true and false. 

Boolean 1 and 0 may be substituted as values. 



Command Examples 



Root> config port extDist 4 false 
Root> config port extDist 4 0 
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config.port.fan 

Syntax 

fan portNumber fanOn 

Purpose 

This command sets the fabric address notification (FAN) state for a port (Edge 
Switch 2/24 only). This configuration can be applied to any port regardless of its 
current configuration. The FAN value is applied at the time the port is configured 
and operated in a loop. 

Parameters 

This command has two required parameters: 

portNumber Specifies the port number. Valid values are: 

0-11 for the Edge Switch 2/12 

0-23 for the Edge Switch 2/24 

fanOn Specifies the FAN state for the port. Valid 

values are true and false. 

Boolean 1 and 0 may be substituted as values. 

Command Examples 

Root> config port fan 4 1 
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config.port.name 

Syntax 

name portNumber "portName" 

Purpose 

This command sets the name for a port. 

Parameters 

This command has two required parameters: 

portNumber Specifies the port number. Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 

portName Specifies the name for the port. The port name 

must not exceed 24 characters in length. 

Command Example 

Root> config port name 4 "HP Tape Drive" 
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config.port.show 



Syntax 

Purpose 

Description 

Parameters 



show portNumber 



This command displays the port configuration for a single port. 



This show command, on the config.port branch, displays the current 
configuration for the specified port. 



This command has one parameter: 

portNumber Specifies the port number. Valid values are: 

0-11 for the Edge Switch 2/12 
0-15 for the Edge Switch 2/16 
0-23 for the Edge Switch 2/24 
0-31 for the Edge Switch 2/32 
0-63 for the Director 2/64 
0-127 and 132-143 for the Director 2/140 



Command Example 



Output 



Root> config port show 4 



The port configuration is displayed as a table that includes the following 
properties: 

Port Number The port number. 
Name The port name. 

Blocked The blocked state. Valid values are true and false. 
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Extended The extended distance configuration state. Valid values are 

Distance true and false. This field is not valid for the Edge 

Switch 2/24. 

FAN The fabric address notification (FAN) state. Valid values 

are true and false. (Edge Switch 2/24 only.) 

Type The port type. Valid values are F Port, E Port, 

G Port, Fx Port (Edge Switch 2/24 only), and 
Gx Port (Edge Switch 2/24 only). 

Speed The port speed. Valid values are 1 Gb/sec, 2 Gb/sec, 

and Negotiate. 



Output Example 

The output from the conf ig . port . show command displays as follows. 

Port Number : 4 

Name : HP4 tape drive 

Blocked: false 

Extended distance: false 

Type: F Port 

Speed: 2 Gb/sec 
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config.port.speed 



Syntax 

speed portNumber portSpeed 

Purpose 

This command sets the speed for a port. 

Description 

A port can be configured to operate at 1.0625 Gbps or 2.125 Gbps, or a negotiated 
speed. 

The port speed can be set only to 1 .0625 Gbps if the switch speed is 1 .0625 Gbps. 
An attempt to set the port speed to 2.125 Gbps or to negotiate in a switch with a 
1 Gbps switch speed results in an error message. 

If the port speed is set to negotiate, the port and the device to which it is attached 
negotiate the data speed setting to either 1.0625 or 2.125 Gbps. 



Note: Port speed changes temporarily disrupt port data transfers. 



Parameters 

This command has two required parameters: 

portNumber Specifies the port number. Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0 - 1 2 7 and 1 3 2 - 1 4 3 for the Director 2/1 40 

portSpeed Specifies the speed of the port. Valid values are 

Ig, 2g, and negotiate. 
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config.port.speed 

Command Examples 

Root> config port speed 4 2g 

Root> config port speed 6 negotiate 
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config.port.type 



Syntax 

Purpose 

Description 



Parameters 



type portNumber portType 



This command sets the allowed type for a port. 



A port can be configured as an F_Port, an E_Port, or a G_Port. On an Edge Switch 
2/12 or 2/24, a port can also be an Fx_Port or Gx_Port. 

On the Edge Switch 2/12, the E_Port, G_Port, and Gx_Port options are not valid, 
unless the Fabric Capable feature is enabled. For more information, see the Edge 
Switch 2/12 Installation Guide. 

The port configurations function as follows: 

■ F_Port — cannot be used as an interswitch link, but may attach to a device with 
an N_Port. 

■ E_Port — only other switch may attach to this type of port. 

■ G_Port — either a device or another switch may attach to this type of port. 

■ Fx_Port — allows arbitrated loop operation in addition to the functionality of 
an F_Port. (Edge Switch 2/12 or 2/24 only.) 

■ Gx_Port — allows arbitrated loop operation in addition to the functionality of 
an F_Port or an E_Port. (Edge Switch 2/12 or 2/24 only.) 



This command has two required parameters: 
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portNumber Specifies the port number. Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0 - 1 2 7 and 1 3 2 - 1 4 3 for the Director 2/140 

portType Specifies the type of the port. Valid values are 

eport, fport, and gport, fxport 
(Edge Switch 2/24 only) gxport (Edge 
Switch 2/24 only). 



Command Example 

Root> config port type 4 fport 
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config.security.fabricBinding Commands 

Fabric Binding functionality, provided by the SANtegrity Binding feature, allows 
you to bind the switch or director to specified fabrics so that it can communicate 
only with those fabrics. With Fabric Binding enabled, the product can 
communicate only with fabrics that are included in the Fabric Binding 
Membership List (FBML). 

Using Fabric Binding, you can allow specific switches to attach to specific fabrics 
in the SAN. This provides security from accidental fabric merges and potential 
fabric disruption when fabrics become segmented because they cannot merge. 

These commands include the following: 



config 


.security 


fabricBinding 


.activatePending, page 67 


config 


.security 


fabricBinding 


.addAttachedMembers, page 68 


config 


.security 


fabricBinding 


.addMember, page 69 


config 


.security 


fabricBinding 


.clearMemList, page 70 


config 


.security 


fabricBinding 


.deactivateFabBind, page 71 


config 


.security 


fabricBinding 


.deleteMember, page 72 


config 


.security 


fabricBinding 


.replacePending, page 73 


config 


.security 


fabricBinding 


.show Active, page 74 


config 


.security 


fabricBinding 


.showPending, page 75 



About Fabric Binding Commands 

The config.security.fabricBinding commands function in a different way from 
most CLI commands, which are single action commands that take effect 
immediately. Most of the Fabric Binding commands affect a temporary copy of an 
FBML in the work area, which is called the Pending FBML. When this temporary 
copy, the pending list, is activated to the fabric, it is called the Active FBML. 



Note: One factor to consider, when using CLI commands to view and configure 
Fabric Binding settings, is that the EWS interface can change Fabric Binding status 
and FBMLs, if it is used at the same time as the CLI. 



Because not all the verification of the Pending FBML can occur on the temporary 
copy in the work area, it is possible, though unlikely, that the copy of the list 
encounters no errors until the list is activated to the fabric. 
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Note: An Edge Switch 2/12 cannot participate in a fabric, unless the Fabric Capable 
feature is enabled. For more information, see the Edge Switch 2/ 1 2 Installation 
Guide. 



Fabric Binding Membership Terminology 

Two types of FBMLs are configured using the CLI: 

■ Active FBML: When fabric binding is active, the active FBML is the list of 
fabric members with which the product is allowed to communicate. If fabric 
binding is disabled, this list is empty. 

■ Pending FBML: A list used to configure an FBML before it is made active on 
the product. Changes to the pending FBML are not implemented in the fabric 
until they are saved and activated using 
config.security.fabricBinding.activatePending. 

The following terms apply to the switches and directors that are part of the 
FBMLs: 

■ Local: The switch or director product that you are configuring. This is a 
required FBML member. 

■ Attached: A switch or director that is currently in a fabric with the local 
product. Any switch and director that is attached is a required FBML member. 

■ Unattached: A switch or director that is not currently in a fabric with the local 
product. These switches and directors are unattached if they have been added 
manually to the pending FBML, or if they are segmented from the local 
fabric. 

Enable/Disable and Online State Functions 

In order for Fabric Binding to function, specific operating parameters and optional 
features must be enabled. Also, there are specific requirements for disabling these 
parameters and features when the director or switch is offline or online. Be aware 
of the following: 

■ Because switches are bound to a fabric by World Wide Name (WWN) and 
domain ID, the Insistent Domain ID option in the Configure Switch 
Parameters dialog box is automatically enabled if Fabric Binding is enabled. 

■ If Fabric Binding is enabled and the switch is online, you cannot disable 
Insistent Domain ID. 
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■ If Fabric Binding is enabled and the director is offline, you can disable 
Insistent Domain ID, but this will disable Fabric Binding. 

■ You cannot disable Fabric Binding if Enterprise Fabric Mode is enabled. 
However, if Enterprise Fabric Mode is disabled, you can disable Fabric 
Binding. 

Fabric Binding can be disabled when the switch is offline. 
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config.security.fabricBinding.activatePending 



Syntax 
Purpose 



Parameters 



activatePending 



This command activates the fabric binding configuration contained in the pending 
work area to the fabric. Members that are attached remain in the list, because the 
Pending FBML must contain all attached members to become active. 



Note: This command takes effect immediately. The CLI verifies the list before activating 
it to the fabric and adds the managed switch to the list, if it is not already present. 



This command has no parameters. 



Command Examples 

Root> config security f abricBinding activatePending 
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config.security.fabricBinding.addAttachedMembers 

Syntax 

addAttachedMembers 

Purpose 

This command adds all the current members of the fabric to the Pending FBML. If 
a fabric member's domain ID or WWN already exists in the list, it is not added. 

Parameters 

This command has no parameters. 
Command Example 

Root> config security f abricbinding addAttachedMembers 
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config.security.fabricBinding.addMember 



Syntax 

addMember wwn domainld 

Purpose 

This command adds a new member to the Fabric Membership List in the pending 
fabric binding work area. The number of entries is limited to the maximum 
available domain IDs for the fabric (31). 



Note: Changes from this command are not activated to the fabric until the 

activatePending command is issued. 



Parameters 

This command has two parameters: 

wwn Specifies the World Wide Name (WWN) of the 

member to be added to the Fabric Membership 
List. The value of the WWN must be in 
colon-delimited hexadecimal notation (for 
example, AA:00:AA:00:AA:00:AA:00). 

domainld The domain ID of the member to be added to the 

Fabric Membership List. Valid domain ID's range 
from 1 to 31. 

Command Examples 

Root> config security f abricBinding addMember 
AA:99 :23 :23 : 08 : 14 : 88 :C1 2 
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Syntax 
Purpose 



ity.fabricBinding.clearMemList 



clearMemList 



This command clears the Fabric Membership List for the pending fabric binding 
working area. Members that are attached remain in the list, because the Pending 
FBML must contain all attached members to become active. 



Note: This information is not saved to the fabric until the activatePending 
command is issued. When the list is cleared, the CLI automatically adds the managed 
switch to the Fabric Membership List. 



This command has no parameters. 
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config.security.fabricBinding.deactivateFabBind 



Syntax 

deactivateFabBind 



Purpose 



This command deactivates the active FBML on the fabric. The Active FBML is 
erased when this command is executed. 



Note: This command takes effect immediately in the fabric. 

Parameters 

This command has no parameters. 
Command Example 

Root> config security f abricbinding deactivateFabBind 
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config.security.fabricBinding.deleteMember 



Syntax 

deleteMember wwn domainld 

Purpose 

This command removes a member from the Fabric Membership List in the 
pending fabric binding work area. The local member and attached members 
cannot be deleted from the list. 



Note: Changes are not activated to the fabric until the activatePending 
command is issued. 



Parameters 

This command has two parameters: 

wwn Specifies the WWN of the member to be removed 

from the Fabric Membership List. The value of the 
WWN must be in colon-delimited hexadecimal 
notation (for example, 
AA:00:AA:00:AA:00:AA:00). 

domainld The domain ID of the member to be removed from 

the Fabric Membership List. Valid domain ID's 
range from 1 to 3 1 . 

Command Examples 

Root> config security f abricBinding deleteMember 
AA: 99 :23 : 23 : 08 : 14 : 88 :C1 

Root> config security f abricBinding deleteMember 2 
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config.security.fabricBinding.replacePending 

Syntax 

replacePending 

Purpose 

This command replaces the pending working area with the fabric binding 
configuration that is currently loaded on the fabric. 

Parameters 

This command has no parameters. 
Command Examples 

Root> config security f abricBinding replacePending 
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config.security.fabricBinding.showActive 



Syntax 

showActive 

Purpose 

This command displays the fabric binding configuration (active FBML) saved on 
the fabric. It performs the same function as "show. security. fabricBinding" on 
page 250. 

Parameters 

This command has no parameters. 

Output 

This command displays the following fabric binding configuration data: 

Domain ID The domain ID of the FBML member. Valid 

domain ID's range from 1 to 2 3 9. 

WWN The world wide name (WWN) of the FBML 

member in colon-delimited hexadecimal 
notation. 

Attachment Status Indicates whether the FBML member is 

Local, Attached, or Unattached. For 
more information, see "Fabric Binding 
Membership Terminology" on page 65. 



Output Example 

The output from the conf ig . security . fabricBinding . showActive 
command displays as follows: 

Domain 1 (20 : 30 : 40 : 50 : 60 : 70 : 8F : 1A) (Local) 

Domain 3 (00:11:22:33:44:55:66:77) (Unattached) 

Domain 2 ( 88 : 99 : AA: BB : CC : DD : EE : FF) (Attached) 

Domain 14 ( 11 : 55 : 3 5 : 45 : 24 : 78 : 98 : FA) (Attached) 
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config.security.fabricBinding.showPending 

Syntax 

showPending 

Purpose 

This command displays the fabric binding configuration in the pending working 
area and has not yet been activated to the fabric. If no changes have been made to 
the pending environment, the CLI displays the active membership list. 

Parameters 

This command has no parameters. 

Output 

The fabric binding configuration data is displayed as a table that includes the 
following properties: 

Fabric Binding State The active fabric binding state: 

Inactive or Active 
Restricting 

Fabric Membership List The active Fabric Membership List. 



Output Example 

The output from the conf ig . security . f abricBinding . showActive 
command displays as follows: 

Fabric Binding State: Active Restricting 
Domain 1 (00:11:22:33:44:55:66:77) 
Domain 2 (88:99: AA : BB : CC : DD : EE : FF ) 
Domain 14 ( 11 : 55 : 3 5 : 45 : 24 : 78 : 98 : FA) 
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config.security.portBinding Commands 

The Port Binding CLI commands enable you to "bind" a specific switch or 
director port to the WWN of an attached node, switch, or director for exclusive 
communication. 

The conf ig . security . portBinding commands include the following: 

■ config.security.portBinding.bound, page 77 

■ conf ig. security .portBinding. show, page 79 

■ conf ig. security .portBinding. wwn, page 81 
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config. security. portBinding. bound 



Syntax 

Purpose 

Parameters 



bound portNumber portBindingState 



This command sets the port binding state for a given port. 



This command has two parameters: 



portNumber 



portBindingState 



Specifies the port number for which the port binding 
state is being set. Valid port number values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 

Specifies the port binding state as active or inactive. 
Valid values are true and false. 

The true parameter sets the port binding to active. 
The specified port will be bound to the WWN 
configured with the 

config. security. portBinding. wwn 
command. If no WWN has been configured, no 
devices can log in to that port. 

The false parameter sets the port binding to 
inactive. Any device is free to connect to the specified 
port in this state, regardless of the WWN setting. 

Boolean 1 and 0 may be substituted as values. 
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Command Examples 

Root> config security portBinding bound 4 true 
Root> config security portBinding bound 4 1 
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config.security.portBinding.show 

Syntax 

show portNumber 

Purpose 

This command shows the port binding configuration for a single port. 

Parameters 

This command has one parameter: 

portNumber Specifies the port number for which the port binding 

configuration will be shown. Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 



Command Example 



Root> config security portBinding show 4 



Output 



The port binding configuration date is displayed as a table that includes the 
following properties: 



Port Number 
WWN Binding 

Bound WWN 



The port number. 

The state of port binding for the specified port, either 
active or inactive. 

The WWN of the device that is bound to the 
specified port. If this field is blank, no device has 
been bound to the specified port. 
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Output Example 

The output from the conf ig . security . portBinding . show command 
displays as follows. 

Port Number : 4 

WWN Binding: Active 

Bound WWN: AA: 99 : 23 : 23 : 08 : 14 : 88 :C1 
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config.security.portBinding.wwn 

Syntax 

wwn portNumber boundWwn 

Purpose 

This command configures the single device WWN to which a port is bound. 

Parameters 

This command has two parameters: 

portNumber Specifies the port number for which the bound WWN is 
being set. Valid port number values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 
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boundWwn Specifies the WWN of the device that is being bound to 
the specified port. The value must be entered in 
colon-delimited hexidecimal notation (for example, 
11 : 22 : 33 : 44 : 55 : 66 :AA:BB). 

If the boundWwn is configured and the 
portBindState is: 

Active — only the device described by boundWwn 
will be able to connect to the specified port. 

Inactive — the WWN is retained, but any device can 
connect to the specified port. 

Instead of the WWN, either of two values can be entered 
in this parameter: 

attached automatically configures the currently 
attached device WWN as the bound WWN. 

remove changes the WWN to the default value, 
00:00:00:00:00:00:00:00. Even though this 
removes the WWN-port association, if the 
portBindingState value set with the 
conf ig . security . portBinding . bound 
command is still true (the port binding is active), 
other devices are prevented from logging in to this port. 
To allow other devices to log in to this port, use the 
conf ig . security . portBinding . bound 
command to set the portBindingState parameter to 
false. 



Command Examples 

Root> config security portBinding wwn 4 AA : 99 : 23 : 23 : 08 : 14 : 88 : CI 

Root> config security portBinding wwn 4 attached 

Root> config security portBinding wwn 4 remove 
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config.security.switchBinding Commands 

Switch Binding CLI commands allow you to enable the product to communicate 
only with nodes, switches, and directors that are listed on the Switch Binding 
Membership List (SBML). Switch Binding restricts connections to only the 
devices listed on the SBML and allows no other devices to communicate with the 
switch. When an unauthorized WWN attempts to log in, it is denied a connection 
and an event is posted to the Event Log. This provides security in environments 
that include a large number of nodes, switches, and directors by ensuring that only 
the specified set of WWNs are able to attach to the managed product. 

You can use the Switch Binding commands to enable Switch Binding and to 
create and change the SBML. Switch Binding is available only if the SANtegrity 
Binding feature is installed. 

The conf ig . security . switchBinding commands include the following: 

■ config.security.switchBinding.addMember, page 84 

■ config.security.switchBinding.deleteMember, page 85 

■ config. security. switchBinding.setState, page 86 

■ config.security.switchBinding.show, page 88 

Enable/Disable and Online State Functions 

For Switch Binding to function, specific operating parameters and optional 
features must be enabled. Also, there are specific requirements for disabling these 
parameters and features: 

■ Switch Binding can be enabled or disabled whether the product is offline or 
online. 

■ Enabling Enterprise Fabric Mode automatically enables Switch Binding. 

■ You cannot disable Switch Binding if Enterprise Fabric Mode is enabled. 
However, if Enterprise Fabric Mode is disabled, you can disable Switch 
Binding. 

■ If Enterprise Fabric Mode is enabled and the director or switch is online, you 
cannot disable Switch Binding. 

■ If Enterprise Fabric Mode is enabled and the director or switch is offline you 
can disable Switch Binding, but this also disables Enterprise Fabric Mode. 

■ WWNs can be added to the SBML without regard to whether Switch Binding 
is enabled or disabled 
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config.security.switchBinding.addMember 



Syntax 

addMember wwn 

Purpose 

This command adds a new member to the Switch Binding Membership List. A 
maximum number of 256 members may be added to the Switch Binding 
Membership List. 

Parameters 

This command has one parameter: 

wwn Specifies the switch or N-Port device WWN of the 

member to be added to the Switch Binding Membership 
List. The value of the WWN must be in colon-delimited 
hexadecimal notation (for example, 
AA: 00 :AA: 00 :AA : 00:AA : 00). 

Command Examples 

Root> config security switchBinding addMember 
AA:99 :23 : 23 : 08 : 14 : 88 :C1 
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config.security.switchBinding.deleteMember 



Syntax 

deleteMember wwn 

Purpose 

This command removes a member from the Switch Binding Membership List. 
The user cannot remove a member that is currently logged into the switch. 

Parameters 

This command has one parameter: 

wwn Specifies the switch or N-Port device WWN of the 

member to be removed from the Switch Binding 
Membership List. The value of the WWN must be in 
colon-delimited hexadecimal notation (for example, 
AA: 00:AA: 00:AA: 00:AA: 00). The user may also 
enter all for this argument to clear the Switch 
Binding Membership List completely. Note that the 
user cannot clear a WWN that is currently logged into 
the switch. 



Command Examples 

Root> config security switchBinding deleteMember 
AA:99 :23 : 23 : 08 : 14 : 88 :C1 
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config.security.switchBinding.setState 



Syntax 

setState switchBindingState 

Purpose 

This command sets the switch binding state on the switch. 

Parameters 

This command has one parameter: 

switchBindingState Sets the switch binding state for the switch. 

Valid values are: 

disable — Disable switch binding. 
Devices (servers, storage, and other 
switches) are allowed to connect to the 
switch without restrictions. 

eRestrict — Enable switch binding and 
restrict E_Port connections. E_Ports are 
prevented from forming ISL connections 
unless explicitly identified in the Switch 
Binding Membership List. F_Port 
connections are allowed without restriction. 

f Restrict — Enable switch binding and 
restrict F_Port connections. Server and (or) 
storage devices are prevented from forming 
F_Port connections with the switch unless 
explicitly identified in the Switch Binding 
Membership List. E_Ports are allowed to 
form ISL connections without restriction. 

allRestrict — Enable switch binding 
and restrict E_Port and F_Port connections. 
Both E_Ports and F_Ports prohibit 
connections with all devices unless 
explicitly identified in the Switch Binding 
Membership List. 
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Command Examples 

Root> config security switchBinding setState allRestrict 
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config.security.switchBinding.show 



Syntax 

show 

Purpose 

This command displays the switch binding configuration. 

Parameters 

This command has no parameters. 

Output 

This command displays the following switch binding configuration data: 

switchBindingState The state of switch binding, which can 

have the following values: Disabled, 
Enabled and Restricting 
F_Ports, Enabled and 
Restricting E_Ports, or 
Enabled and Restricting All 
Ports. 

Switch Binding Membership List The WWNs of members of the SBML 

saved on the switch. 



Output Example 

The output from the conf ig . security . portBinding . show command 
displays as follows: 

Switch Binding State: Enabled and Restricting E Ports 
00 : 11 :22 : 33 :44 : 55 : 66 : 77 
88:99: AA : BB : CC : DD : EE : FF 
11:55:35:45:24:78:98:FA 
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config.security.userRights Commands 

The conf ig . security . userRights commands include the following: 

■ config.security.userRights. administrator, page 90 

■ config.security.userRights.operator, page 91 

■ config.security.userRights. show, page 92 
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config.security.userRights.administrator 



Syntax 

Purpose 

Description 

Parameters 



administrator "username" "password" 



This command sets the name and password for administrator-level access. 



Immediately after the name and password for the administrator is set, you will be 
prompted to log in with the new access rights. 



This command has two parameters: 

username Specifies the new user name for administrator-level login. 

Default is set to Administrator. 

This parameter is 1-15 characters. 

Valid characters include all characters in the USASCII 
character set, excluding control characters and spaces. 

Spaces are not valid even though quotation marks are used. 

password Specifies the password for administrator-level login. 

Default is set to password. 

This parameter is 1-15 characters. 

Valid characters include all characters in the USASCII 
character set, excluding control characters and spaces. 

Spaces are not valid even though quotation marks are used. 



Command Example 



Root> config security userRights administrator "Administrator" 
"newpassword" 
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config.security.userRights.operator 

Syntax 

operator "username" "password" 

Purpose 

This command sets the name and password for operator-level access. 

Parameters 

This command has two parameters: 

username Specifies the new user name for operator-level login. 

Default is Operator. 

This parameter is 1-15 characters. 

Valid characters include all characters in the US ASCII 
character set, excluding control characters and spaces. 

Spaces are not valid even though quotation marks are used. 

password Specifies the password for operator-level login. 

Default is password. 

This parameter is 1-15 characters. 

Valid characters include all characters in the US ASCII 
character set, excluding control characters and spaces. 

Spaces are not valid even though quotation marks are used. 

Command Example 

Root> config security userRights operator "Operator" 
"newpassword" 
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config.security.userRights.show 



Syntax 

Purpose 

Parameters 



show 



This command shows the user rights for the CLI access levels. 



This command has no parameters. 



Command Example 

Root> config security userRights show 



Output 



The user rights configuration data is displayed as a table that includes the 
following properties: 

Operator Username The username for operator privileges. 

Operator Password The password for operator privileges. 

Administrator Username The username for administrator privileges. 

Administrator Password The password for administrator privileges. 



Output Example 



The output from the config . security .userRights . show command 
displays as follows. 

Operator Username: Operator 
Operator Password: ************** 
Administrator Username: Administrator 
Administrator Password: *************** 
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config.snmp.add Commands 

The conf ig . snmp . add commands include the following: 

■ config.snmp.addCommunity, page 94 

■ config.snmp.authTraps, page 95 

■ config.snmp.deleteCommunity, page 96 

■ config.snmp.setFaMib Version, page 97 

■ config.snmp.setState, page 98 

■ config.snmp.show, page 99 
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config.snmp.addCommunity 



Syntax 

addCommunity commlndex "commName" writeAuthorization 
trapRecipient udpPortNum 

Purpose 

This command adds an SNMP community to the SNMP configuration. 

Parameters 

This command has five parameters. Up to six community names and trap 
recipients may be defined. 

commlndex Specifies the community to be created or edited. 

Valid values are integers in the range 1-6. 

commName Specifies the community name of the community 

specified by commlndex. 

The community name must not exceed 32 characters in 
length. Valid characters include all those in the ISO 
Latin- 1 character set. Duplicate community names are 
allowed, but the corresponding 
wri teAuthorization values must match. 

Specifies the write authorization state of the community. 

Valid values are enabled and disabled. Boolean 2 
and 0 may be substituted as values. 

Specifies the trap recipient. Values must be 4 bytes in 
dotted-decimal format. 

udpPortNum Specifies the user datagram protocol (UDP) port number 

to which the director sends traps for each recipient. 

The value can be a decimal number or the default, which 
162. Valid values include all legal UDP port numbers. 

Command Example 

Root> config snmp addCommunity 1 "CommunityNamel " enabled 
123.123.123.123 162 



writeAuthorization 



trapRecipient 



94 



CLI Reference Guide for Directors and Edge Switches 



config.snmp.authTraps 



config.snmp.authTraps 



Syntax 
Purpose 



Parameters 



authTraps enabledState 



This command enables or disables the authorization traps to be sent to SNMP 
management stations when unauthorized stations try to access SNMP information 
from the director or edge switch. 



This command has one parameter: 

enabledState Specifies whether the authorization traps are 

enabled. 

Valid values are true and false. 

Boolean 1 and 0 may be substituted as values. 

Command Examples 

Root> config snmp authTraps true 
Root> config snmp authTraps 1 
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config.snmp.deleteCommunity 



Syntax 
Purpose 



deleteCommunity commlndex 



This command entirely deletes a community from the SNMP. 



Parameters 

This command has one parameter: 

commlndex Specifies the community to be deleted. 

Valid values are integers in the range 1-6. 

This value was set in the commlndex parameter of the 
conf ig . snmp . addCommunity command. 

Valid values are integers in the range 1-6 . 

Command Example 

Root> config snmp deleteCommunity 5 
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config.snmp.setFaMibVersion 



Syntax 

setFaMibVersion versionNumber 

Purpose 

This command sets the version of the Fibre Alliance MIB with which the SNMP 
agent interacts. The version number can be set to 3.0 or 3.1. 

Parameters 

This command has one parameter. 

versionNumber Sets the version of the Fibre Alliance MIB 
version number. Accepted values for this 
command are 3 . 0 or 3 . 1. 

Command Example 

Root> conf ig snmp setFaMibVersion 3 . 1 
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config.snmp.setState 

Syntax 

setState enabledState 

Purpose 

This command enables or disables the SNMP agent. When disabled, the SNMP 
agent does not respond to any requests or send any traps. 

Parameters 

This command has one parameter. 

enabledState Sets the state of the SNMP agent. This 

parameter can be set to enabl e or di sabl e. 
Boolean 1 and 0 values may also be 
substituted. 

Command Example 

Root> config snmp setState 1 
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config.snmp.show 



Syntax 

Purpose 

Parameters 



show 



This command shows the switch SNMP configuration. 



This command has no parameters. 



Command Example 



Output 



Root> config snmp show 



The switch configuration data is displayed as a table that includes the following 
properties: 



SNMP Agent State 



FA MIB Version 
Number 

Authorization Traps 



Index 

Community Name 
writeAuth 
Trap Recipient 



The state of the SNMP agent. If it is disabled, 
the SNMP state does not respond to any 
requests and does not produce any traps. 

Version of the MIB that the SNMP agent is 
configured to use. 

The state of the authorization traps (for 
example, enabled) that will be sent to SNMP 
management stations when unauthorized 
stations attempt to access SNMP information 
from the switch. 

The community index number. 

The name of the community. 

The write authorization state. 

The address of the trap recipient shown in 
4-byte dotted-decimal format. 
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UDP Port The user datagram protocol (UDP) port number 

to which the director will send traps for each 
recipient. 

Output Example 

The output from the conf ig . snmp . show command displays as follows. 

SNMP Agent State: Enabled 

FA MIB Version Number: 3.0 

Authentication Traps : Enabled 

Index Community Name WriteAuth Trap Recipient UDP Port 



1 CommunityNamel Enabled 123.123.123.123 162 

2 CommunityName2 Enabled 10.25.25.10 144 

3 CommunityName3 Disabled 132.44.85.224 162 

4 public Enabled 162 
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config.switch Commands 

All of the conf ig . switch commands, except for the 

conf ig . switch . show command, require that the switch be set offline. (Use 
the maint . system . setOnlineState to set the switch offline.) If these 
commands are entered while the switch is online, an error message results. 

The conf ig . switch commands include the following: 



coniig 


.swiicn.uu^reQii, page ruz 




config 


. switch. domainRSCN, pag( 


i 1 CO. 


config 


.switch.insistDomainld, pa 


^e 1U4 


config 


.switch.ltdFabRSCN, page 


105 


config 


.switch.edTOV, page 106 




config 


.switch.interopMode, page 


107 


config 


.switch.prefDomainld, pagt 


; 108 


config 


.switch.priority, page 109 




config 


.switch.raTOV, page 111 




config 


.switch.rerouteDelay, page 


112 


config 


.switch. speed, page 114 




config 


.switch.show, page 115 




config 


.switch.zoningRSCN, page 117 
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conf ig .switch . bbCred it 

Syntax 

bbCredit bbCreditValue 

Purpose 

This command sets the buffer-to-buffer credit value for all ports, except those 
ports configured for extended distance. (The Edge Switch 2/24 does not accept 
this command.) 

Description 

The switch must be set offline before this command is entered. 

Parameters 

This command has one parameter: 

bbCreditValue Specifies the new buffer-to-buffer credit value. 

This parameter must be an integer in the range 
1-60. 

Command Example 

Root> config switch bbCredit 2 
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config. switch. domainRSCN 



Syntax 

domainRSCN doma inRSCNSt ate 

Purpose 

This command sets the domain RSCN state for the switch. The switch can be 
either offline or online when this command is executed. When this parameter is 
enabled, domain register for state change notifications (domain RSCNs) are sent 
between end devices in a fabric to provide additional connection information to 
host bus adapters (HBA) and storage devices. As an example, this information 
might be that a logical path has been broken because of a physical event, such as a 
fiber optic cable being disconnected from a port. 

Parameters 

This command has one parameter: 

domainRSCN State Specifies whether the domain RSCN state is 

enabled or disabled. Valid values are enable 
and disable. Boolean 1 and 0 may be 
substituted as values. 

Command Example 

Root> config switch domainRSCN 1 



Note: The Insistent Domain ID must be enabled, if the Enterprise Fabric Mode (an 
optional SANtegrity feature) or Preferred Path is enabled. 
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config.switch.insistDomainld 



Syntax 

insistDomainld insistentDomainldState 

Purpose 

This command sets the insistent domain ID state for the switch. 

Parameters 

This command has one parameter: 

insistentDomainldState Specifies whether the insistent domain 

ID state is enabled or disabled. Valid 
values are enable and disable. 
Boolean 1 and 0 may be substituted as 
values. 



Command Example 

Root> config switch insistDomainld 1 
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conf ig .switch . ltd Fa b RSC N 



Syntax 

ItdFabRSCN ltdFabRSCNState 



Purpose 



This command sets the status of limited fabric RSCNs. When enabled, fabric 
register for state change notifications (RSCNs) are suppressed during an IPL. 



Description 

The switch must be set offline before this command is entered. 

Parameters 

This command has one parameter. 

ltdFabRSCNState Specifies whether the limited fabric RSCN state is 

enabled. Valid values are enabl e and di sabl e. 
Boolean 1 and 0 may be substituted as values. 



Command Example 

Root> config switch ItdFabRSCN 1 
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config. switch. edTOV 



Syntax 

Purpose 

Description 



Parameters 



edTOV timeoutValue 



This command sets the E D TOV for the switch. 



The switch must be set offline before this command is entered. 

Special care should be used when scripting this command due to its relationship 
withR A TOV. 



This command has one parameter: 

timeoutValue Specifies the new E_D_TOV value. 

The units for this value are tenths of a second. 

This parameter must be an integer in the range 
2-600 (0.2 second to 60 seconds), and it must be 
smaller than the R A TOV. 



Command Example 



Root> config switch edTOV 4 
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config .switch .interopMode 

Syntax 

interopMode interopMode 

Purpose 

This command sets the interoperability mode for the switch. The switch must be 
offline to complete this command. 

Description 

The switch must be set offline before this command is entered. 

Parameters 

This command has one parameter: 

interopMode Specifies the interoperability mode. 

Valid values are: 

■ mcda ta (for Homogenous Fabric mode) 

■ open (for Open Fabric 1.0 mode) 

Command Example 

Root> config switch interopMode open 
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config .switch . pref Doma i n Id 



Syntax 

pref Domainld domainld 

Purpose 

This command sets the preferred domain ID for the switch. 

Description 

The switch must be set offline before this command is entered. 

Parameters 

This command has one parameter: 

domainld Specifies the new preferred domain ID value. 

This parameter must be an integer in the range 1 -31. 

Command Example 

Root> config switch pref Domainld 1 
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conf ig .switch .priority 



Syntax 

priority switchPriority 

Purpose 

This command sets the switch priority. 

Description 

The switch must be set offline before this command is entered. 

Parameters 

This command has one parameter: 



CLI Reference Guide for Directors and Edge Switches 



109 



CLI Commands 



switchPriority Specifies the switch priority. Valid values are: princi pal, 
defaul t, or neverprincipal. 

m principal — sets the numerical switch priority to 1. 
The switch with a priority of 1 becomes the principal 
switch; however, if two or more switches have a priority 
of 1 , the switch with the lowest WWN becomes the 
principal switch. 

■ defaul t — sets the numerical switch priority to 254. 
If no switch is set to principal, the switch with a priority 
254 becomes the principal switch; however, if two or 
more switches have a priority of 254, the switch with the 
lowest WWN becomes the principal switch. 

■ neverprincipal — sets the numerical switch 
priority to 255. This switch is not able to become the 
principal switch. 



Note: At least one switch in a multiswitch fabric must have a 
switch priority value of principal or default. 



Note: The number codes 2-253 are not currently in use. 



Command Example 

Root> config switch priority principal 



no 
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conf ig .switch . raTOV 



Syntax 

Purpose 

Description 



Parameters 



raTOV timeoutValue 



This command sets the R A TOV for the switch. 



The switch must be set offline before this command is entered. 

Special care should be used when scripting this command due to its relationship 
withE D TOV. 



This command has one parameter: 

timeoutValue Specifies the new R_A_TOV value. 

The units for this value are tenths of a second. 

This parameter must be an integer in the range 
10-1200 (1 second to 120 seconds), and must be 
larger than the E_D_TOV. 



Command Example 



Root> config switch raTOV 2 0 
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config .switch . rerouteDelay 



Syntax 

rerouteDelay rerouteDelayState 

Purpose 

This command enables or disables rerouting delay for the switch. 

Description 

The switch can be either offline or online when this command is executed. 

This command is only applicable if the configured switch is in a multiswitch 
fabric. Enabling the rerouting delay ensures that frames are delivered in order 
through the fabric to their destination. 

If there is a change to the fabric topology that creates a new path (for example, a 
new switch is added to the fabric), frames may be routed over this new path if its 
hop count is less than a previous path with a minimum hop count. This may result 
in frames being delivered to a destination out of order because frames sent over 
the new, shorter path may arrive ahead of older frames still in route over the older 
path. 

If rerouting delay is enabled, traffic ceases in the fabric for the time specified in 
the config . switch . edTOV command. This delay allows frames sent on the 
old path to exit to their destination before new frames begin traversing the new 
path. Note that during this delay period, frames addressed to the destinations that 
are being rerouted are discarded if they are Class 3 frames and rejected if they are 
Class 2 or Class F frames. 

Parameter 

This command has one parameter: 

rerouteDelayState Specifies whether rerouting delay is enabled. 

Valid values are true and false. 

Boolean 2 and 0 may be substituted as 
values. 



112 



CLI Reference Guide for Directors and Edge Switches 



config. switch. rerouteDelay 



Command Examples 

Root> config switch rerouteDelay true 
Root> config switch rerouteDelay 1 
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config. switch. speed 



Syntax 
Purpose 



speed swi tchSpeed 



This command sets the speed for the switch. 



Note: This command is only applicable for the Director 2/64. Edge switches and the 
Director 2/140 cannot change speed. 



Description 



Parameters 



The switch must be set offline before this command is entered. 

A switch can be configured to operate at 1.0625 Gbps or 2.125 Gbps. 

If the switch has fibre port module (FPM) cards, configuring the switch speed to 
2.125 Gbps makes all the ports on the FPM cards inactive, and their operational 
state will be set to inactive. FPM ports do not support 2.125 Gbps and, therefore, 
will remain inactive after the switch is returned to the online state. 



This command has one required parameter: 
switchSpeed Specifies the speed of the switch. 



Valid values are Ig (for 1.0625 Gbps) or 2g 
(for 2.125 Gbps). 



Command Examples 

Root> config switch speed 2g 
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config. switch. show 



Syntax 
Purpose 
Parameters 
Description 



show 



This command shows the switch configuration. 



This command has no parameters. 



This switch can be either offline or online when this command is executed. 



Command Example 



Output 



Root> config switch show 



The switch configuration data is displayed as a table that includes the following 
properties: 

BB Credit The maximum number of outstanding frames that can be 

transmitted without causing a buffer overrun condition at 
the receiver. 



R_A_TOV 
E D TOV 



Preferred 
Domain Id 

Switch Priority 



Resource Allocation Time Out Value. 
This value is set in tenths of a second. 
Error Detect Time Out Value. 
This value is set in tenths of a second. 
The preferred domain ID of the switch. 

The switch priority. 

Values are Principal, Default, or Never 
Principal. 
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Speed 



The switch speed. (This parliamentary is not valid for the 
Edge Switch 2/24.) 

The rerouting delay that ensures that frames are delivered 
in order through the fabric to their destination. 



Rerouting 
Delay 



Values are Enabled or Disabled. 



Interop Mode 

Insistent 
Domain Id 



Interoperability mode for the switch. 



When enabled, ensures that the embedded firmware cannot 
change a switch's preferred domain ID. 



Domain RSCN When enabled, allows domain RSCNs to be sent to 
registered members of the fabric 

Zoning RSCN When enabled, allows zoning RSCNs to be sent to 
registered members of the fabric 

Limited Fabric When enabled, fabric RSCNs are suppressed after an IPL. 



RSCN 

Output Example 

The output from the conf ig . switch . show command displays as follows. 



BB Credit: 2 

R_A_TOV : 2 0 

E_D_TOV : 4 

Preferred Domain Id: 1 



Switch Priority: Principal 
Speed: 2 Gb/sec 

Rerouting Delay: Enabled 



Interop Mode: Open Fabric 1.0 



Insistent Domain Id: Disabled 

Domain RSCN: Enabled 

Zoning RSCN: Disabled 

Limited Fabric RSCN: Disabled 
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config.switch.zoningRSCN 



Syntax 

zoningRSCN zoningRSCNState 

Purpose 

This command sets the zoning RSCN state for the switch. When enabled, this 
parameter allows zoning register for state change notifications (RSCNs) to be sent 
to registered members of the fabric. Zoning RSCNs are sent to ports on the switch 
following any change to the fabric's active zone set. The switch can be either 
offline or online when this command is executed. 

Parameters 

This command has one parameter: 

zoningRSCNState Specifies whether the zoning RSCN state is 
enabled. Valid values are enabl e and 
disable. Boolean 1 and 0 may be 
substituted as values. 

Command Example 

Root> config switch zoningRSCN 1 
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config. system Commands 

The config. system commands include the following: 

■ config. system.contact, page 119 

■ config.system.date, page 120 

■ config. system.description, page 121 

■ config. system.location, page 122 

■ config.system.name, page 123 

■ config.system.show, page 124 
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config.system.contact 

Syntax 

contact "systemContact" 

Purpose 

This command sets the system contact attribute. 

Parameters 

This command has one parameter: 

systemContact Specifies the new system contact string for the 

director or edge switch. 

The contact can contain 0-255 characters. 

Command Example 

Root> config system contact "Joe" 
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config.system.date 



Syntax 

Purpose 

Parameters 



date sysDate sysTime 



This command sets the system date and time. 



This command has two required parameters: 

sysDate Specifies the new system date. 

The format of the date parameter must be mm:dd:yyyy or 
mm/dd/yyyy. 

Valid date values include: 

■ mm: 1-12 
m dd: 1-31 

m yyyy: >1980 
sysTime Specifies the new system time. 

The format of the time parameter must be hh:mm:ss. 
Valid time values include: 

■ hh: 0-23 

■ mm: 0-59 
m ss: 0-59 



Command Examples 



Root> config system date 04:16:2001 10:34:01 
Root> config system date 10/09/2001 14:07:55 
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config .system .descri ption 

Syntax 

description "systemDescription" 

Purpose 

This command sets the system description string. 

Parameters 

This command has one parameter: 

systemDescription Specifies the new system description string for 

the director or edge switch. 

The name can contain 0-255 characters. 

Command Example 

Root> config system description "hp StorageWorks director 2/64" 
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config .system . location 

Syntax 

location "systemLocation" 

Purpose 

This command sets the system location attribute. 

Parameters 

This command has one parameter: 

systemLocation Specifies the new system location for the director or edge 
switch. 

The location can contain 0-255 characters. 

Command Example 

Root> config system location "Everywhere" 
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config.system.name 

Syntax 

name "systemName" 

Purpose 

This command sets the system name attribute. 

Parameters 

This command has one required parameter: 

systemName Specifies the new system name for the director 

or edge switch. 

The name can contain 0-24 characters. 

Command Example 

Root> config system name "hp edge switch 2/32" 
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config. system. show 



Syntax 

show 

Purpose 

This command shows the system configuration. 

Parameters 

This command has no parameters. 
Command Example 

Root> config system show 

Output 

The system configuration is displayed as a table that includes the following 
properties: 

Name The system name. 

Description The system description. 

Contact The system contact. 

Location The system location. 

Date/Time The system date and time. 

Output Examples 

The output from the config . system . show command displays as follows. 

Name: hp director 

Description: hp StorageWorks director 2/64 

Contact : Joe 

Location: Everywhere 

Date/Time: 04/16/2001 10:34:01 
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config.zoning Commands 

The config . zoning commands function in a different way from the other CLI 
commands, which are single action commands that take effect immediately. A 
zoning configuration is typically too complicated to be described by a single 
command, so the first zoning command entered invokes a work-area editor. The 
commands take effect on a temporary copy of a zone set in the work area until the 
temporary copy in the work area is activated to the fabric — or is discarded. 

Because not all the verification of the zone set can occur on the temporary copy in 
the work area, it is possible, however unlikely, that the copy of the zone set 
encounters no errors until the zone set is activated to the fabric. 



Note: Port numbers cannot be used for zone members if the interoperability mode for 
the switch or director is set to Open Fabric 1 .0 mode. In this case, you must use node 
WWNs as zone members. 



Note: An Edge Switch 2/12 cannot participate in a fabric, unless the Fabric Capable 
feature is enabled. For more information, see the Edge Switch 2/ 1 2 Installation 
Guide. 



The config.zoning commands include the following: 



config 


.zoning 


.setDefZoneState, page 127 


config 


.zoning 


activateZoneSet, page 128 


config 


.zoning 


deactivateZoneSet, page 129 


config 


.zoning 


.replaceZoneSet, page 130 


config 


.zoning 


clearZoneSet, page 131 


config 


.zoning 


addZone, page 132 


config 


.zoning 


deleteZone, page 133 


config 


.zoning 


renameZoneSet, page 134 


config 


.zoning 


.addWwnMem, page 135 


config 


.zoning 


.addPortMem, page 136 


config 


.zoning 


clear Zone, page 138 


config 


.zoning 


delete WwnMem, page 139 
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■ config.zoning.deletePortMem, page 140 

■ config.zoning.renameZone, page 141 

■ config.zoning.showPending, page 142 

■ config.zoning.showActive, page 143 
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config.zoning.setDefZoneState 

Syntax 

setDef ZoneState defaultZoneState 

Purpose 

This command enables or disables the default zone and takes effect immediately 
fabric wide. 

Description 

This command takes effect immediately in the fabric. 

Parameters 

This command has one parameter: 

defaultZoneState Specifies whether the default zone is enabled. 

Valid values are true and false. 

Boolean 1 and 0 may be substituted as values. 

Command Examples 

Root> config zoning setDef ZoneState false 
Root> config zoning setDef ZoneState 0 
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config.zoning.activateZoneSet 



Syntax 

activateZoneSet 

Purpose 

This command activates the zone set contained in the work area to the fabric and 
takes effect immediately. 

Description 

This command takes effect immediately in the fabric. 

Parameters 

This command has no parameters. 
Command Example 

Root> config zoning activateZoneSet 



Note: If the interoperability mode for the switch or director is set to Open Fabric 1 .0 
mode when the zone is activated, any zone members specified by port number are 
ignored. 
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config.zoning.deactivateZoneSet 



Syntax 
Purpose 



Description 



deactivateZoneSet 



This command places all attached devices in the default zone if the default zone is 
enabled and takes effect immediately for the entire fabric. If the default zone is 
not enabled, there will be no zoning in effect and all attached devices will be 
unable to communicate with any other attached device. This command clears both 
the active zone set and the working area. 



The default zone must be activated independently of this command. 



Note: This command takes effect immediately in the fabric. 



Parameters 



This command has no parameters. 



Command Example 



Root> config zoning deactiveZoneSet 
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conf ig .zoning. replaceZoneSet 

Syntax 

replaceZoneSet 

Purpose 

This command replaces the work area with the active zone set that is currently 
loaded on the fabric. 

Parameters 

This command has no parameters. 
Command Example 

Root> config zoning replaceZoneSet 
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config.zoning.clearZoneSet 

Syntax 

clearZoneSet 

Purpose 

This command clears the zone set contained in the work area, removing all zones, 
and takes effect immediately. 

Description 

This command does not change the zone set name. 

Parameters 

This command has no parameters. 
Command Example 

Root> config zoning clearZoneSet 
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config.zoning.addZone 



Syntax 
Purpose 

Description 

Parameters 



addzone "zoneName" 



This command adds a new (empty) zone to the zone set in the work area. (A 
switch or director can have a maximum of 1024 zones.) 



Changes are not activated on the switch until the 

conf ig . zoning . activateZoneSet command is issued. 



This command has one parameter: 

zoneName Specifies the name of the new zone. 

The zoneName must contain 1-64 characters. 
Valid characters are: 

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrs 
tuvwxyzO 12 34567 89$- A _ 

Spaces are not permitted, and the first character must be 
alphabetical. 



Command Example 



Root> config zoning addzone TheUltimateZone 
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config.zoning.deleteZone 

Syntax 

deleteZone "zoneName" 

Purpose 

This command deletes a zone from the zone set in the work area. 

Description 

Changes are not activated on the switch until the 

config . zoning . activeZoneSet command is issued. 

Parameters 

This command has one parameter: 
zoneName Specifies the name of the zone to be deleted. 

Command Example 

Root> config zoning deleteZone TheLeastUltimateZone 
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conf ig .zoning, rena meZoneSet 



Syntax 

renameZoneSet "zoneSetName" 

Purpose 

This command changes the name of the zone set in the work area. 



Description 



Changes are not activated on the switch until the 

conf ig . zoning . activateZoneSet command is issued. 



Parameters 

This command has one parameter: 

zoneSetName Specifies the new name for the zone set. 

The zoneSetName must contain 1-64 characters. 
Valid characters are: 

ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmno 
pqrstuvwxyz0123456789$- A _ 

Spaces are not permitted, and the first character must be 
alphabetical. 

Command Example 

Root> config zoning renameZoneSet TheUltimateZoneSet 
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conf ig .zoning .add WwnMem 



Syntax 
Purpose 

Description 
Parameters 



addWwnMem "zoneName" wwn 



This command adds a World Wide Name zone member to the specified zone in 
the work area. 



A product can have a maximum of 1024 zone members in its zones. 



This command has two parameters 

ZoneName 
wwn 



Specifies the name of the zone. 

The World Wide Name of the member to be added to 
the zone. 



The value of the WWN must be in colon-delimited 
hexadecimal notation. 

For example : AA: 00 :AA: 00 :AA: 00 :AA: 00. 



Command Example 



Root> config zoning addWwnMem TheUltimateZone 
10:00:00:00:C9:22:9B:64 
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conf ig .zon i ng . add PortMem 



Syntax 
Purpose 



addPortMem "zoneName" domainld portNumber 



This command adds the domain ID and port number of a zone member to the 
specified zone in the work area. 



Note: Port numbers cannot be used for zone members if the interoperability mode for 
the switch or director is set to Open Fabric 1 .0 mode. 



Description 



Parameters 



A product can have a maximum of 1024 zone members in its zones. 

This command has three parameters: 

Specifies the name of the zone. 

Specifies the domain ID of the member to be 
added to the zone. 

Valid values are in the range 1-31. 

Specifies the port number of the member to be 
added to the zone. 

Valid port number values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 



ZoneName 
domainld 



portNumber 
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Command Example 

Root> config zoning addPortMem TheUltimateZone 10 6 
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config.zoning.clearZone 



Syntax 

clearZone "zoneName" 

Purpose 

This command clears all zone members for the specified zone in the work area. 

Description 

This command does not change the zone name. 

Parameters 

This command has one parameter: 
zoneName Specifies the name of the zone to be cleared. 

Command Example 

Root> config zoning clearZone TheNotUltimateAtAllZone 
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config.zoning.deleteWwnMem 

Syntax 

deleteWwnMem " zoneName" wwn 

Purpose 

This command removes a WWN member from a zone that is in the work area. 



Parameters 

This command has two parameters: 

zoneName Specifies the name of the zone that contains the member to 

be deleted. 

wwn Specifies the World Wide Name of the member to be 

deleted from the zone. 

The value of the WWN must be in colon-delimited 
hexidecimal notation. 

For example: AA : 00:AA: 00 :AA : 00:AA: 00. 



Command Example 



Root> config zoning deleteWwnMem TheNotSoUltimateZone 
10:00:00:00:C9:22:9B:AB 
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config.zoning.deletePortMem 



Syntax 
Purpose 

Parameters 



deletePortMem "zoneName" domainld portNumber 



This command deletes a domain ID and port number for a zone member in the 
specified zone in the work area. 



This command has three parameters: 

zoneName Specifies the name of the zone that contains the member to 

be deleted. 

domainld Specifies the domain ID of the member to be deleted from 

the zone. 

Valid domain IDs are in the range 1-31. 

portNumber Specifies the port number of the member to be deleted 

from the zone. 

Valid port numbers values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

00-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 



Command Example 



Root> config zoning deletePortMem TheUltimateZone 10 5 
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config.zoning.renameZone 



Syntax 

Purpose 

Parameters 



renameZone "oldZoneName" "newZoneName" 



This command renames a zone in the work area. 



This command has two parameters: 

oldZoneName Specifies the current zone name of the zone to 
be renamed. 

newZoneName Specifies the new zone name. The 

newZoneName must contain 1-64 characters. 

Valid characters are: 

ABCDEFGHIJKLMNOPQRSTUVWXYZabcde 
fghijklmnopqrstuvwxyz$-*_ 

Spaces are not permitted, and the first character 
must be alphabetical. 



Command Example 

Root> config zoning renameZone TheOldUltimateZone 
TheUltimateZone 
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config.zoning.showPending 



Syntax 

showPending 

Purpose 

This command shows the zoning configuration in the work area of the zone set 
that has not yet been activated. 

Parameters 

This command has no parameters. 
Command Example 

Root> config zoning showPending 

Output 

The zoning configuration data is displayed as a table that includes the following 
properties: 

Local ZoneSet The enabled status, name, and member zones of the 

zone set. 

Output Example 

The output from the config . zoning . showPending command displays as 
follows. 

Pending Zone Set 
Default Zone Enabled: False 
ZoneSet : TheNewUltimateZoneSet 
Zone: TheNewUltimateZone 

ZoneMember : Domain 10, Port 6 
ZoneMember : Domain 15, Port 2 
Zone: TheNewNotSoUltimateZone 

ZoneMember : 10 : 00 : 00 : 00 : C9 : 22 : 9B:AB 
ZoneMember : 10:00:00:00: C9:22:9B:C6 
ZoneMember : 10 : 00 : 00 : 00 : C9 : 22 : 9B:AB 
Zone: TheNewNotUltimateAtAllZone 

ZoneMember: Domain 2, Port 63 
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config.zoning.showActive 



Syntax 

Purpose 

Parameters 



showActive 



This command shows the zoning configuration saved on the fabric. 



This command has no parameters. 



Command Example 



Output 



Root> config zoning showActive 



The zoning configuration data is displayed as a table that includes the following 
properties: 

Active ZoneSet The enabled status, name, and member zones of the 

zone set. 



Output Example 



The output from the config . zoning . showActive command displays as 
follows. 

Active Zone Set 
Default Zone Enabled: False 
ZoneSet: TheUltimateZoneSet 
Zone: TheUltimateZone 



ZoneMember 
ZoneMember 
ZoneMember 
ZoneMember 
ZoneMember 



Domain 10 
Domain 15 
Domain 2 , 
10 : 00 
10 : 00 



Port 6 
Port 2 
Port 63 
00 : 00 :C9 : 22 
00 : 00 :C9 :22 



9B: 64 
9B:BD 



Zone : 



Zone : 



TheNotSoUltimateZone 
ZoneMember: 10 : 00 : 00 : 00 : C9 : 22 
ZoneMember: 10 : 00 : 00 : 00 : C9 : 22 
ZoneMember: 10 : 00 : 00 : 00 : C9 : 22 

TheNotUltimateAtAllZone 
ZoneMember: Domain 2, Port 63 



AB 
C6 
AB 
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maint Commands 

The maint branch of the CLI command tree contains commands that relate to 
maintenance activities. 

The commands in the maint branch can be used only by the administrator. 

Note that the maint . system. resetConf ig command resets all 
configuration data and non- volatile settings, including network information, to 
their default values (factory settings). Management access may be lost until the 
network information is restored. 

The maint commands include the following: 

■ maint.port.beacon, page 145 

■ maint.port.reset, page 146 

■ maint.system.beacon, page 147 

■ maint.system.clearSysError, page 148 

■ maint.system.ipl, page 149 

■ maint.system.resetConfig, page 150 

■ maint.system.setOnlineState, page 151 
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maint.port.beacon 



Syntax 

Purpose 

Parameters 



beacon portNumber beaconState 



This command enables or disables port beaconing for a port. 



This command has two required parameters: 

portNumber Specifies the port number. 

Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 

beaconState Specifies whether unit beaconing is enabled. 

Valid values are true and false. 

Boolean 1 and 0 may be substituted as values. 



Command Examples 



Root> maint port beacon 4 false 
Root> maint port beacon 4 0 
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ma int. port, reset 



Syntax 

Purpose 

Description 



Parameters 



reset portNumber 



This command resets a port. 



This command resets an individual port without affecting any other ports. 
However, if a device is attached to the port and the device is online, the reset 
causes a link reset to occur. If the port is in a failed state (that is, after failing a 
loopback test), the reset restores the port to an operational state. The reset also 
clears all statistics counters and disables port beaconing for the specified port. 



This command has one parameter: 

portNumber Specifies the port number to be reset. 

Valid values are: 
0-11 for the Edge Switch 2/12 
0-15 for the Edge Switch 2/16 
0-23 for the Edge Switch 2/24 
0-31 for the Edge Switch 2/32 
0-63 for the Director 2/64 
0-127 and 132-143 for the Director 2/140 



Command Example 

Root> maint port reset 4 
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maint.system.beacon 

Syntax 

beacon beaconState 

Purpose 

This command enables or disables unit beaconing. 

Parameters 

This command has one parameter: 

beaconState Specifies whether unit beaconing is enabled. 

Valid values are true and false. 

Boolean 1 and 0 may be substituted as values. 

Command Examples 

Root> maint system beacon false 
Root> maint system beacon 0 
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maint.system.clearSysError 



Syntax 

clear SysError 

Purpose 

This command clears the system error light. 

Parameters 

This command has no parameters. 
Command Example 

Root> maint system clearSysError 
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maint.system.ipl 



Syntax 

i P i 

Purpose 

This command IPLs the switch. 

Description 

Connection to the command line interface is lost when this command runs. 

Parameters 

This command has no parameters. 
Command Example 

Root> maint system ipl 
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ma i nt.system . resetConf ig 



Syntax 

resetConf ig 

Purpose 

This command resets all NVRAM configuration parameters to their default 
values, including feature keys and IP addresses. 

Description 

This command IPLs the switch. Connection from the CLI to the switch is lost 
when this command runs. 



Note: This command resets all configuration data and non-volatile settings, including 
network information, to their default values (factory settings). Management access may 
be lost until the network information is restored. 



The default values are set in the firmware of the director or edge switch. For 
information about the default values, refer to the service manual for your director 
or edge switch. 

Parameters 

This command has no parameters. 
Command Example 

Root> maint system resetConfig 
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maint.system.setOnlineState 

Syntax 

setOnlineState onlineState 

Purpose 

This command sets the switch online or offline. 

Parameters 

This command has one parameter: 

onlineState Specifies whether the switch is online. 

Valid values are true and false. 

Boolean 1 and 0 may be substituted as values. 

Command Examples 

Root> maint system setOnlineState true 
Root> maint system setOnlineState 1 
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perf Commands 

The perf branch of the CLI command tree contains commands that relate to 
performance services. 

The commands in the perf branch can by used by either the administrator or the 
operator. 

Note that the counters in perf command output are 32-bit values that wrap at 
4,294,967,296. To calculate the full value of a counter, multiply 4,294,967,296 by 
the value in the wrap field, and add the resulting product to the value in the count 
field. For example, if a TxFrames statistic has a count value of 1842953 and a 
wrap value of 12, the full value of the counter is: 

(4,294,967,296 x 12) + 1842953 = 51,541,450,505. 

The perf commands include the following: 

■ perf.class2, page 153 

■ perf.class3, page 155 

■ perf.clearStats, page 157 

■ perf. errors, page 158 

■ perf. link, page 160 

■ perf.openTrunking.congestionThresh, page 163 

■ perf.openTrunking.lowBBCreditThresh, page 164 

■ perf.opentrunking.setState, page 165 

■ perf.openTrunking.show, page 166 

■ perf.openTrunking.unresCongestion, page 168 
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perf.class2 

Syntax 
Purpose 
Parameters 



class2 portNumber 



This command displays port Class 2 counters for a single port. 



This command has one parameter: 

portNumber Specifies the port number. 

Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 



Command Example 

Root> perf class2 2 

Output 

The port Class 2 counter data is displayed as a table that includes the following 
statistics, along with a wrap count for each corresponding counter: 

Port The port number. 

RxFrames The number of Fibre Channel Class 2 frames that the 

port has received. 

TxFrames The number of Fibre Channel Class 2 frames that the 

port has transmitted. 
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RxWords 
TxWords 
Busied Frms 



Rjct Frames 



The number of Class 2 4-byte words within frames 
that the port has received. 

The number of Class 2 4-byte words within frames 
that the port has transmitted. 

The number of times that FBSY (Fabric Busy link 
response) was returned to this port as a result of a 
Class 2 frame that could not be delivered to the other 
end of the link. 

This occurs if either the fabric or the destination port 
is temporarily busy. 

The number of times that FRJT (Frame Reject link 
response) was returned to this port as the result of a 
Class 2 frame that was rejected by the fabric. 



Output Example 

The output from the perf.class2 command displays as follows. 



Port 2 

Statistic Count Wrap 

RxFrames 2953184 23 

TxFrames 1842953 12 

RxWords 2943184 65 

TxWords 1842953 32 

Busied Frms 2953184 0 

Rjct Frames 1842953 0 
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perf.class3 

Syntax 
Purpose 
Parameters 



class3 portNumber 



This command displays port Class 3 counters for a single ports. 



This command has one parameter: 

portNumber Specifies the port number. 

Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 



Command Example 

Root> perf class3 2 

Output 

The port Class 3 counter data is displayed as a table that includes the following 
statistics, along with a wrap count for each corresponding counter: 

Port The port number. 

RxFrames The number of Fibre Channel Class 3 frames that the 

port has received. 

TxFrames The number of Fibre Channel Class 3 frames that the 

port has transmitted. 
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Rx Words The number of Class 3 4-byte words within frames that 

the port has received. 

Tx Words The number of Class 3 4-byte words within frames that 

the port has transmitted. 

Disc Frames The number of Class 3 frames that have been discarded 
upon receipt by this port. 

There are no FBSYs (Fabric Busy link response) or 
FRJTs (Frame Reject link response) generated for Class 
3 frames. 



Output Example 

The output from the perf.class3 command displays as follows. 

Port 2 

Statistic Count Wrap 



RxFrames 2953184 23 

TxFrames 1842953 12 

RxWords 2953184 65 

TxWords 1842953 32 

Disc Frames 2953184 26 



156 



CLI Reference Guide for Directors and Edge Switches 



perf.clearStats 



perf.clearStats 

Syntax 



Purpose 



clearStats portNumber 



This command resets all port statistics for an individual port or for all ports. 



Parameters 

This command has one parameter: 

portNumber Specifies the port number. 

Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 

all for every port on the director or edge 
switch 

Command Example 

Root> perf clearStats 4 
Root> perf clearStats all 
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perf.errors 

Syntax 
Purpose 
Parameters 



errors portNumber 



This command displays port error counters for a single port. 



This command has one parameter: 

portNumber Specifies the port number. 

Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 



Command Example 

Root> perf errors 2 

Output 

The port error counter data is displayed as a table that includes the following 
statistics: 

Port The port number. 

Prim Seq Err The number of state machine protocol errors 

detected by the port hardware. 
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Disc Frms The number of received frames discarded due to a 

frame size of less than size words or to frames 
dropped because the BB credit was zero. 

This number is counted during the first round of 
frame verification and applies to both Class 2 and 
Class 3 traffic. 

Inv Tx Wrds The number of 10-bit transmission words that the 

port is unable to map to 8-bit bytes because of 
disparity errors or misaligned K characters while in 
the OL2 or 0L3 state. 

CRC Errs The number of frame CRC errors detected by the 

port. 

Dlim Errs The number of invalid frame delimiters (SOF or 

EOF) received by the port. 

Addr Id Errs The number of frames received with unknown 

addressing. 



Output Example 

The output from the perf . errors command displays as follows. 



Port 2 

Statistic Count 

Prim Seq Err 753452 
Disc Frms 351269 
Inv Tx Wrds 2953184 
CRC Errs 1842953 
Delim Errs 2953184 
Addr Id Errs 1842953 
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perf.link 

Syntax 

Purpose 

Parameters 



link portNumber 



This command displays port link counters for a single ports. 



This command has one parameter: 

portNumber Specifies the port number. 

Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 



Command Example 

Root> perf link 2 

Output 

The port link counter data is displayed as a table that includes the following 
statistics: 

Port The port number. 

OLS In The number of offline sequences initiated by the 

attached N_Port. 

OLS Out The number of offline sequences initiated by this 

director or edge switch port. 
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Reset In The number of link resets initiated by the attached 

N_Port. 

Reset Out The number of link resets initiated by this director or 

edge switch. 

LIPS In The number of LIPS generated on this switch loop 

port. 

LIPS Out The number of times the port has detected a link 

error resulting from an invalid link state transition or 
timeout. 

Link Firs The number of times the port has detected a link 

error resulting from an invalid link state transition or 
timeout. 

Sync Losses The number of times the port has detected a loss of 

synchronization timeout while not in an offline or 
LF2 state. 

Sig Losses The number of times the port has detected a loss of 

signal while not in an offline or LF2 state. 



Output Example 

The output from the perf . link command displays as follows. 



Port 2 

Statistic Count 

OLS In 753452 

OLS Out 351269 

Reset In 2953184 

Reset Out 1842953 

Link Firs 2953184 

Sync Losses 1842953 

Sig Losses 35246 
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perf.openTrunking. backPressure 



Syntax 

backpressure backPressureState 

Purpose 

This command configures the Back Pressure state of the OpenTrunking 
configuration. 

Parameters 

This command has one parameter: 

backPressureState This parameter can be set to enabl e or 
di sabl e OpenTrunking back pressure. 
Boolean 1 and 0 values may also be 
substituted. If the state is configured to be 
enabled, a back pressure entry is made to the 
Event Log and an SNMP trap is generated if 
SNMP is configured. 

Command Example 

Root> perf OpenTrunking backpressure 1 
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perf.openTrunking.congestionThresh 



Syntax 
Purpose 

Parameters 



congestionThresh portNumber congestionThreshold 



This command configures the congestion threshold for an individual port or for all 
ports. 



This command has the following parameters: 



portNumber 



congestionThreshold 



Specifies the port number. Valid values are: 

0-22 for the Edge Switch 2/12 

0-25 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-227 and 132-143 for the Director 2/140 

all applies the congestionThreshold 
value to every port on the product. 

Specifies the congestion threshold in terms of 
a percentage. Valid values are integers in the 
range 2 to 99 or defaul t. Specifying the 
value default sets the specified port to the 
default threshold level of 10. 



Command Example 



Root> perf openTrunking congestionThresh 8 20 
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perf.openTrunking.lowBBCreditThresh 



Syntax 

LowBBCreditThresh lowBBcreditThreshold 

Purpose 

This command configures the low BB_credit threshold of the OpenTrunking 
configuration. The low BB_credit threshold is defined as the percentage of time 
that no transmit BB_Credits are passed on the link. When the threshold value is 
exceeded, the system tries to reroute the flows that are going to the ISL with the 
problem. Effectively, the threshold is the percent of the time that the port does not 
receive BB_Credits before traffic is rerouted away from the port. 

This threshold is also used for prevention of improperly rerouting to an ISL that 
lacks BB_Credits. In other words, the system does not reroute a flow to a link that 
lacks BB_Credits even if that link is significantly under its loading threshold. The 
system tries to reroute traffic away from a link that lacks BB_Credits, even if the 
loading threshold is significantly below the limit. 

Parameters 

This command has one parameter: 

lowBBcreditThreshold Specifies the credit starvation threshold in 

terms of a percentage. Valid values are 
integers in the range 1 to 99 or defaul t. 
Specifying the value default sets the 
parameter to the default threshold level of 
10%. 

Command Example 

Root> perf openTrunking creditStarvThresh 2 0 



164 



CLI Reference Guide for Directors and Edge Switches 



perf.opentrun king. setS tate 



perf.opentrunking.setState 



Syntax 

setState openTrunkingState 

Purpose 

This command sets the enabled state of the OpenTrunking feature. The 
OpenTrunking feature key must be installed in order to enable open trunking. 

Parameters 

This command has one parameter. 

openTrunkingState This parameter can be set to enabl e or di sabl e 
the OpenTrunking feature. Boolean 1 and 0 may be 
substituted as values. 

Command Example 

Root> perf opentrunking setState 1 



Note: The command "confiq. features. opentrunking" on page 47 has functionality that 
is identical to this commancT. 
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perf.openTrunking.show 

Syntax 

show portNumber 

Purpose 

This command displays the current OpenTrunking configuration per port. 

Parameters 

This command has one parameter: 

portNumber Specifies the port number. Valid values are: 

0-11 for the Edge Switch 2/12 
0-15 for the Edge Switch 2/16 
0-23 for the Edge Switch 2/24 
0-31 for the Edge Switch 2/32 
0-63 for the Director 2/64 
0-127 and 132-143 for the Director 2/140 

Command Example 

Root> perf openTrunking show 11 

Output 

The OpenTrunking configuration data is displayed as a table that includes the 
following statistics: 

Congestion Threshold The threshold listed as a percentage. If the 

value is a default value, (default) is 
displayed next to the percentage. 

Flows Rerouted To Trunking statistic displaying flows rerouted to 

the specified port. (These statistics are cleared 
by the perf . clearStats command.) 
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Flows Rerouted From 



Unresolved Congestion 



Backpressure 



Low BB Credit Threshold 



Trunking statistic displaying flows rerouted 
from the specified port. (These statistics are 
cleared by the perf.clearStats command.) 

The current enabled/disabled state of the 
unresolved congestion trunking feature. (The 
indicated state applies to every port on the 
product.) 

The current enabled/disabled state of the 
backpressure trunking feature. (The indicated 
state applies to every port on the product.) 

The current threshold setting of the Low BB 
Credit Threshold trunking feature. If the value 
is a default value, (default) is displayed 
next to the percentage. (The indicated value 
applies to every port on the product.) 



Output Example 



The output from the per f . openTrunking . show command displays as 
follows. 

Port Number : 1 

Congestion Threshold (%): 56 

Flows Rerouted To: 2 673 9 

Flows Rerouted From: 23987 

Unresolved Congestion: Enabled 

Backpressure: Disabled 

Low BB Credit Threshold (%) : 75 (default) 
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perf .openTru n ki ng . u n resCongestion 



Syntax 

unresCongestion unresolvedCongestionState 

Purpose 

This command configures the Unresolved Congestion state of the OpenTrunking 
configuration. If the state is configured to be enabled, an unresolved congestion 
entry is made to the Event Log and an SNMP trap is generated if SNMP is 
configured. 

Parameters 

This command has one parameter: 

unresolvedCongestionState This parameter can be set to enabl e or 

disable the Unresolved Congestion 
state of the OpenTrunking configuration. 
Boolean 1 and 0 values may also be 
substituted. 

Command Example 

Root> perf OpenTrunking unresCongestion 1 
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perf . preferred Path 

The perf.preferredPath commands enable you to use the Preferred Path feature to 
influence the route of data traffic that traverses multiple switches or directors in a 
fabric. If more than one ISL connects switches in your SAN, this feature is useful 
for specifying an ISL preference for a particular flow. 

The Preferred Path feature allows the user to enhance the system's path selection 
algorithm by providing the ability to prioritize ISLs for a selected port on the 
switch. The Preferred Path capability customizes the static load-balancing 
function by allowing the user to specify an ISL preference for each remote 
domain. Preferred Path, however, is still subject to the standard Fabric Shortest 
Path First (FSPF) requirements, which allow the firmware to override the 
configuration setting if errors are encountered. 

The data path consists of the source port of the switch or director being 
configured, the exit port of that switch or director, and the domain ID of the 
destination switch or director. Each switch or director must be configured for its 
part of the desired path in order to achieve optimal performance. You may need to 
configure Preferred Paths for all switches or directors along the desired path for a 
proper multi-hop Preferred Path. (For examples of Preferred Path implementation 
and other related information, see your product's Element Manager manual.) 

■ The following rules apply when configuring Preferred Paths: 

■ The switch's domain ID must be set to insistent. 

■ Domain IDs must be in the range of 1 through 31. 

■ The specified numbers for source ports and exit ports must be in the range 
equal to the number of ports for the switch being configured. 

■ For any source port, only one path may be defined to each destination domain 
ID. 



Note: For E/OS 6.0 only, the Preferred Path feature key must be installed to use 
preferred path commands. For E/OS 6.1 , a feature key is not required. 
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The perf.preferredPath commands include the following: 

■ perf.preferredPath.clearPath, page 171 

■ perf.preferredPath.setPath, page 172 

■ perf.preferredPath.setState, page 174 

■ perf.preferredPath.showPath, page 175 
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perf . preferred Path .clea rPath 

Syntax 

clearPath destDomainlD sourcePort 

Purpose 

This command deletes a preferred path. The command causes the specified path to 
use a path selection algorithm that is different from the preferred path. All 
configured paths can be removed by specifying the all parameter for both the 
destination domain ID and source port. 

Parameters 

This command has the following parameters: 

destDomainld Specifies the destination domain ID. Valid 
domain IDs are in the range 1-31 or all, 
which deletes all preferred paths to and from the 
source port specified in the sourcePort 
parameter. 

sourcePort Specifies the number of the source port. Valid 

port numbers values are: 

0-11 for the Edge Switch 2/12 

0-25 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0 -1 2 7 and 1 3 2 -1 4 3 for the Director 2/140 

Or you can specify all to delete all paths to the 
destination domain ID. 

Command Example 

Root> perf pref erredPath clearPath 10 5 
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perf.preferredPath.setPath 

Syntax 

setPath destDomainlD sourcePort exitPort 

Purpose 

This command sets a preferred exit port given the destination domain ID and 
source port. An exit port can be set for each combination of destination domain ID 
and source port. 

Parameters 

This command has the following parameters: 

destDomainld Specifies the destination domain ID. Valid 
domain IDs are in the range 1 -31. 

sourcePort Specifies the number of the source port. Valid 

port numbers values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 

exitPort Specifies the number of the desired exit port. 

Valid port numbers values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 
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Command Example 

Root> perf pref erredPath setPath 17 5 11 
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perf.preferredPath.setState 

Syntax 

setState enabledState 

Purpose 

This command enables or disables the Preferred Path feature. 

Note: Insistent domain IDs must be used in order to enable the preferred path state. 

Parameters 

This command has one parameter. 

enabledState Sets the state of the preferred path 

feature. When disabled, the preferred path 
settings are ignored for all path selection 
decisions. Accepted values for this 
command are enabl e and di sabl e. 
Boolean 1 and 0 be substituted as values. 

Command Example 

Root> perf pref erredPath setState enable 
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perf.preferredPath.showPath 



Syntax 

showPath destDomainID sourcePort 

Purpose 

This command displays the requested Preferred Path configuration. The output 
shows the configured preferred exit port. Using all for either the destination 
domain ID or the specified sourcePort parameter results in output that shows all 
configured and actual exit ports for the other parameter. If the destination domain 
is set to all, then all paths from the specified source port are displayed. If the 
source port is set to all, the output shows all source port paths to the specified 
domain. You cannot specify all for both of those parameters. 

Parameters 

This command has the following parameters: 

destDomainld Specifies the destination domain ID. Valid 
domain IDs are in the range 1-31 or all, 
which shows all paths to and from the source 
port specified in the sourcePort parameter. 

sourcePort Specifies the number of the source port. Valid 

port numbers values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 

Or, you can specify all to show all paths to the 
destination domain ID specified for the 
destDomainld parameter. 
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Output 



The output from perf.prefeiTedPath.showPath includes the following parameters: 

Destination The destination domain ID for which a 

Domain preferred path has been configured. This is 

displayed only if the destination domain 

parameter is set to all. 

Source Port This is the source port for which a preferred 

path to the specified destination domain ID is 
specified. This is displayed only if the source 
port parameter is set to all. 

Preferred Exit The configured Preferred Path exit port. This 
Port value can be any port number, or blank to 

indicate that no Preferred Path has been 

configured. 



Command and Output Examples 

The following examples show the output returned by the three methods of 
specifying the perf.preferredPath.showPath command. 

Single values for both parameters 

Root> perf pref erredPath showPath 21 10 
Preferred Path State: Enabled 
Preferred Exit Port: Not Configured 

destDomainld set to all 

Root> perf pref erredPath showPath all 15 
Preferred Path State: Enabled 
Destination Domain Preferred Exit Port 



1 23 

3 24 

4 23 
17 12 

sourcePort set to all 

Root> perf pref erredPath showPath 1 all 

Preferred Path State: Enabled 

Source Port Preferred Exit Port 



0 2 
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3 17 
22 5 



perf .preferred Path .showPath 
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perf.thresholdAlerts Commands 

The perf.thresholdAlerts commands enable you to configure alerts that notify you 
of specific conditions on your system. 

You can configure a maximum of 16 threshold alerts, including both counter 
threshold alerts (CTAs) and throughput threshold alerts (TTAs). Each of these 
types of alerts have commands that are specific to the alert type. 

■ Counter threshold alerts: These are alerts that are triggered by counts of 
events. The commands used to configure these alerts start with 

perf . thresholdAlerts . counter . 

■ Throughput threshold alerts: These alerts are triggered by port throughput. 
The commands used to configure these alerts start with 

perf . thresholdAlerts . throughput. 

These commands include the following: 

■ perf.thresholdAlerts.counter.addAlert, page 183 

■ perf.thresholdAlerts.counter.addPort, page 184 

■ perf.thresholdAlerts.counter.removePort, page 186 

■ perf. thresholdAlerts.counter.setCounter, page 187 

■ perf.thresholdAlerts.counter.setParams, page 188 

■ perf.thresholdAlerts.counter.show, page 190 

■ perf.threshAlerts.counter.showStatisticTable, page 191 

■ perf.thresholdAlerts.deleteAlert, page 192 

■ perf.thresholdAlerts. setState, page 193 

■ perf.thresholdAlerts.throughput.addAlert, page 194 

■ perf.thresholdAlerts. throughput. addPort, page 196 

■ perf.thresholdAlerts.throughput.removePort, page 198 

■ perf.thresholdAlerts.throughput.setUtilType, page 199 

■ perf.thresholdAlerts.throughput.SetUtilPercentage, page 200 

■ perf.thresholdAlerts.throughput.setParams, page 201 

■ perf. threshold Alerts, throughput, show, page 203 

■ perf.thresholdAlerts.throughput.showUtilTypeTable, page 204 

For a list of the available threshold alerts counters, see "Alert Types and 
Counters" on page 180. 
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Note: The perf.thresholdAlerts commands are standard command line interface 
features. They do not require a feature key. 



Creating Threshhold Alerts 

The tasks you need to complete to create and activate a threshold alert differ 
depending on the type of alert you are creating. To implement a counter threshold 
alert, see "Activating a Counter Threshold Alert" on page 179. To implement a 
throughput alert, see "Activating a Throughput Threshold Alert" on page 180. 

Activating a Counter Threshold Alert 

In order to activate a counter threshold alert using the CLI, you must enter certain 
commands in order. Enable the threshold alert using the following order: 

1. Create a counter threshold alert using the command 
perf.thresholdAlerts.counter.addAlert. Use this command to create a name for 
the threshold alert that you can use in subsequent commands. The threshold 
alert must then be configured using the other counter threshold alert 
commands. 

2. Assign the threshold alert to a port using the command 
perf . threshold Alerts .counter . addPort. 

3. Configure the threshold alert using other perf.thresholdalert commands. For 
example, you may want to associate the threshold alert counter with the 
threshold alert name using the command 

perf.thresholdAlerts.counter.setCounter. Use the following commands to 
view alert settings and configure an alert: 

■ perf.thresholdAlerts.counter.removePort 

■ perf.thresholdAlerts.counter.setCounter 

■ perf.thresholdAlerts.throughput.setParams 

■ perf. threshold Alerts, counter . show 

■ perf.threshAlerts.counter.showStatisticTable 

4. Once the alert is fully configured, it can be activated using the command 
perf.thresholdAlerts. setState. An alert cannot be modified unless it is in the 
disabled state. 
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Activating a Throughput Threshold Alert 

In order to activate a throughput threshold alert using the CLI, you must enter 
certain commands in order. Enable the threshold alert using the following order: 

1 . Create a throughput threshold alert using the command 
perf.thresholdAlerts.throughput.addAlert. Use this command to create a name 
for the threshold alert that you can use in subsequent commands. The 
threshold alert must then be configured using the other throughput threshold 
alert commands. 

2. Assign the threshold alert to a port using the command 
perf . threshold Alerts . throughput. addPort. 

3. Identify the throughput statistic that triggers the throughput threshold alert 
using the command perf.thresholdAlerts.throughput.setUtilType. 

4. Identify the percentage of throughput that triggers the throughput threshold 
alert using the command perf.thresholdAlerts.throughput.SetUtilPercentage. 

5. Configure the threshold alert using other perf. threshold Alerts commands. For 
example, you may want to set the duration and interval times for the alert, as 
described in perf.thresholdAlerts.throughput.setParams. Use the following 
commands to view alert settings and configure an alert: 

■ perf.thresholdAlerts.throughput.removePort 

■ perf.thresholdAlerts.throughput.setParams 

■ perf. threshold Alerts . throughput, show 

■ perf.thresholdAlerts.throughput.showUtilTypeTable 

6. Once the alert is fully configured, it can be activated using the command 
perf.thresholdAlerts.setState. An alert cannot be modified unless it is in the 
disabled state. 

Alert Types and Counters 



Table 4 provides a list of throughput threshold alerts. 
Table 4: Throughput Threshold Alerts 







Tx Util 


TTA - Transmit Utilization 


Rx Util 


TTA - Receive Utilization 


Tx/Rx Util 


TTA - Transmit or Receive Utilization 



180 



CLI Reference Guide for Directors and Edge Switches 



perf.preferredPath.showPath 



Table 5 provides a list of threshold alert counters and counter sets. 
Table 5: List of Threshold Alert Counters 



Number 


Threshold Alert Counter or Counter Set 


1 


Link Kesets bent 


z. 


Link Resets Received 


Q 

0 


(JLb bent 


A 

4 


ULb Received 


zr 
D 


Link Failures 


z 
O 


bync Losses 


"7 


c:„„„| | „„„„„ 
bignal Losses 


Q 
O 


Protocol Errors 


o 

V 


Invalid Ix Words 


1 U 


cor c ~ „ 

LKL errors 


1 1 


Discarded Frames 


1 z. 


Frames Too Short 


1 0 


Delimiter Errors 


14 


Address ID Errors 


15 


Class2BusiedFrames 


16 


Class2ReiectedFrames 

1 


17 


Class3DiscardedFrames 


18 


Physical Link Errors Set (see below) 


19 


Link Sequence Counts Set (see below) 


20 


Logical Link Errors Set (see below) 


21 


LIPS Detected (Edge Switch 2/12 and 2/24 
only) 


22 


LIPS Generated (Edge Switch 2/12 and 2/24 
only) 
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Description of Summed Sets 

Some of the threshold alerts consist of groups of related items called 
Summed Sets. When any of the items in the summed set are encountered, the total 
value of the summed set counter is incremented. The items that make up the 
summed sets are: 

Physical Link Errors Summed Set 

— Link Failures 

— Sync Losses 

— Signal Losses 

— Protocol Errors 

— Invalid Tx Words 

— CRC Errors 

— Frames Too Short 

— Delimiter Errors 

■ Link Sequence Counts Summed Set 

— Link Resets Received 

— Link Reset Sent 

— OLS Received 

— OLS Sent 

■ Logical Link Errors Summed Set 

— Discarded Frames 

— Address ID Errors 

— Class 2 Busied Frames 

— Class 2 Rejected Frames 

— Class 3 Discarded Frames 
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perf.thresholdAlerts.counter.addAlert 

Syntax 

addAlert name 

Purpose 

This command configures a new counter threshold alert and assigns it a name. 
The new alert is assigned default settings which can then be changed using the 
other counter threshold alert commands. 

The default settings for a new counter threshold alert are as follows: 

■ Ports: None 

■ Counter: None 

■ Increment: 100 

■ Interval: 60 minutes 

■ State: Disabled 

Parameters 

This command has one parameter: 

name Specifies the name of the new counter threshold alert. 

This name can consist of any ASCII characters up to a 
maximum length of 64 characters. To use spaces or 
special characters in this name, put quotation marks 
around the name. This parameter is case-sensitive. 



Note: Although the system supports a name length of 64 characters, you may want to 
use a much shorter name. Some commands that display the threshold name show a 
maximum of 51 characters. If you specify lengthy names, you can display the 
complete name by entering the comma-delimited mode using the commaDelim 
command. 



Command Example 

Root> perf thresholdAlerts counter addAlert checklinks 
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perf.thresholdAlerts.counter.addPort 



Syntax 
Purpose 



Parameters 



addPort name portNumber 



This command adds a port to the specified counter threshold alert. 



Note: An alert cannot be modified unless it is in the disabled state. 



This command has the following parameters: 

name The name of a counter threshold alert as defined by the 

command "perf.thresholdAlerts. counter. addAlert" on 
page 183. 
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portNumber Specifies the port number or port type. Valid values are 

either a single port number, all ports, or port type. The 
following port numbers are valid: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 

all applies the congestionThreshold value to every 
port on the product. 

Specifying a port type removes all the ports from the alert 
and applies the alert to each port that is the specified type of 
port. Valid values are: 

■ eport 

■ fport 

■ f lport (Edge Switch 2/24 only) 

A counter threshold alert is not allowed to specify both port 
types and individual port numbers. 

Command Example 

Root> perf thresholdAlerts counter addPort checklinks 12 
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perf.thresholdAlerts.counter.removePort 

Syntax 

removePort name portNumher 

Purpose 

This command removes a port from the specified counter threshold alert. 
Note: An alert cannot be modified unless it is in the disabled state. 

Parameters 

This command has the following parameters: 

name The name of a counter threshold alert as 

defined by the command 
"perf.thresholdAlerts.counter.addAlert" on 
page 183. 

portNumber Specifies the port number. Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 

all removes every port on the product from 
the counter threshold alert. 

Command Example 

Root> perf thresholdAlerts counter removePort checklinks 12 
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perf.thresholdAlerts.counter.setCounter 



Syntax 

setCounter name counterNumber 

Purpose 

This command sets the counter statistic that will be used to trigger the counter 
threshold alert. Use this command to associate a counter with the threshold alert 
name created using the command "perf.thresholdAlerts.counter.addAlert" on 
page 183. 



Note: An alert cannot be modified unless it is in the disabled state. Verify that the 
alert is disabled before executing this command. 



Parameters 

This command has the following parameters: 

name The name of a counter threshold alert as 

defined by the command 
"perf.thresholdAlerts.counter.addAlert" on 
page 183. 

counterNumber Specifies the counter number. Valid values 
are shown in Table 5. 

Command Example 

Root> perf thresholdAlerts counter setCounter checklinks 1 
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perf.thresholdAlerts.counter.setParams 



Syntax 
Purpose 



setParams name increment interval 



This command sets the increment and interval times for a specified counter 
threshold alert. 



Note: An alert cannot be modified unless it is in the disabled state. 



Parameters 



This command has the following parameters: 



name 



increment 



interval 



The name of a counter threshold alert as 
defined by the command 
"perf.thresholdAlerts.counter.addAlert" on 
page 183. 

This sets the number of times a counter must 
increment during the interval period to trigger 
the alert. Acceptable values are in the range 
of 1 to 70, 560. 

This sets the interval time in minutes for the 
alert. Acceptable values are in the range of 5 
to 70, 560 minutes. 



Example 

The meaning for each of these inputs can best be described using the following 
example sentence: 

If ports 0, 1 , or 2 CRC Error counter increments more then 5 times within a period 
of 30 minutes, send an alert. Where: 

Port list = 0, 1, 2 
CTA Counter = CRCErrors 
Increment value= 5 
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Interval Time = 3 0 minutes 



The increment value takes place in an interval that is a fixed length amount of 
time. This interval is not a rolling window interval. 



Command Example 

Root> perf thresholdAlerts counter setParams checklinks 5 3 0 
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perf.thresholdAlerts.counter.show 

Syntax 

show name 

Purpose 

This command displays the settings for an individual counter threshold alert. 

Parameters 

This command has one parameter: 

name The name of a threshold alert as defined by the 

command "perf.thresholdAlerts.counter.addAlert" on 
page 183. 



Note: The output of this command truncates threshold alert names that are longer 
than 51 characters. If you specify lengthy names, you can display the complete name 
by entering the comma-delimited mode using the commaDelim command. 



Command Example 

Root> perf thresholdAlerts counter show checklinks 



Output Example 



The output from the perf . thresholdAlerts . counter . show command 
displays as follows. 



Index : 3 

Name : Example_CRC_Error_Finder 

Ports: 2,4-7,20-24 

Counter Statistic: CRC Errors 

Increment : 5 

Interval : 3 0 

Alert State: Disabled 
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perf.threshAlerts.counter.showStatisticTable 



Syntax 
Purpose 



showStatisticTable 



This command displays the table of different statistic counters that can be added 
to a counter threshold alert. This table is used for reference only. 



Parameters 

This command has no parameters. 
Command Example 

Root> perf ThreshAlerts counter showStatisticTable 

Output Example 

The output from the showStatisticTable command displays as follows. 

NumberCounter or Counter Set 



1 Link Resets Sent 

2 Link Resets Received 

3 OLS Sent 

4 OLS Received 

5 Link Failures 

6 Sync Losses 

7 Signal Losses 

8 Protocol Errors 

9 Invalid Tx Words 

10 CRC Errors 

11 Discarded Frames 

12 Frames Too Short 

13 Delimiter Errors 

14 Address ID Errors 

15 Cls2 BusiedFrms 

16 Cls2 RejectedFrms 

17 Cls3 DiscardFrms 

18 Phys Lnk Err Set 

19 Lnk Seq Cnt Set 

2 0 Logic Lnk Err Set 

21 LIPS Detected 

22 Lips Generated 
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perf.thresholdAlerts.deleteAlert 



Syntax 

deleteAlert name 

Purpose 

This command deletes a specified threshold alert. 



Note: An alert cannot be modified unless it is in the disabled state. Verify that the 
alert is disabled before executing this command. 



Parameters 

This command has one parameter. 

name The name of a threshold alert as defined by the 

commands perf.thresholdAlerts.counter.addPort 
and perf.thresholdAlerts.throughput.addAlert, 
or, enter all to delete all of the configured 
threshold alerts. 
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perf.thresholdAlerts.setState 

Syntax 

setState name enabledState 

Purpose 

This command sets the enabled state of the specified counter threshold alert. 

Parameters 

This command has the following parameters: 

name The name of a counter threshold alert as 

defined by the command 
"perf.thresholdAlerts.counter.addAlert" on 
page 183. 

enabledState Sets the counter threshold alert enabled state. 

Valid values are enabl ed and di sabl ed. 
Boolean 1 and 0 values may also be 
substituted. 

Command Example 

Root> perf thresholdAlerts setState checklinks enabled 
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perf.thresholdAlerts. throughput. addAlert 

Syntax 

addAlert name 

Purpose 

This command configures a new throughput threshold alert and assigns it a name. 
The new alert is assigned default settings that can then be changed using the other 
throughput threshold alert commands. 

The default settings for a new counter threshold alert are as follows: 

■ Ports: None 

■ Utilization Type: None 

■ Utilization Percentage: 50% 

■ Duration: 30 minutes 

■ Interval: 60 minutes 

■ Alert State: Disabled 

Parameters 

This command has the following parameter. 

name Specifies the name of the new throughput 

threshold alert. This name can consist of any 
ASCII characters up to a maximum length of 
64 characters. To use spaces or special 
characters in this name, put quotation marks 
around the name. This parameter is 
case-sensitive. 



Note: Although the system supports a name length of 64 characters, you may want to 
use a much shorter name. Some commands that display the threshold name show a 
maximum of 51 characters. If you specify lengthy names, you can display the 
complete name by entering the comma-delimited mode using the commaDelim 
command. 
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Command Example 

Root> perf thresholdAlerts throughput addAlert port6Rx 
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perf.thresholdAlerts. throughput. addPort 

Syntax 

addPort name portNumber 

Purpose 

This command adds a port to the specified throughput threshold alert. 

Note: An alert cannot be modified unless it is in the disabled state. Verify that the 
alert is disabled before executing this command. 
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Parameters 

This command has the following parameters: 

name The name of a throughput threshold alert as 

defined by the command 
"perf.thresholdAlerts.throughput.addAlert" on 
page 194. 

portNumber Specifies the port number or port type. Valid 

values are either a single port number, all 
ports, or port type. The following port 
numbers are valid: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-12 7 and 132-143 for the Director 2/140 

all applies the throughput threshhold alert to 
every port on the product. 

Specifying a port type removes all the ports 
from the alert and applies the alert to each port 
that is the specified type of port. Valid values 
are: 

■ eport 

■ fport 

■ flport (Edge Switch 2/12 or 2/24) 

A counter threshold alert is not allowed to 
specify both port types and individual port 
numbers. 



Command Example 

Root> perf thresholdAlerts throughput addPort eportRx eport 
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perf.thresholdAlerts.throughput.removePort 

Syntax 

removePort name portNumher 

Purpose 

This command removes a port from the specified throughput threshold alert. 

Note: An alert cannot be modified unless it is in the disabled state. Verify that the 
alert is disabled before executing this command. 

Parameters 

This command has the following parameters: 

name The name of a throughput threshold alert as 

defined by the command 
"perf.thresholdAlerts.throughput.addAlert" on 
page 194. 

portNumber Specifies the port number. Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-12 7 and 132-143 for the Director 2/140 

all removes every port on the product from 
the counter threshold alert. 

Command Example 

Root> perf thresholdAlerts throughput removePort eportRx all 
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perf.thresholdAlerts. throughput. setUtilType 



Syntax 
Purpose 



setUtilType name utilizationType 



This command sets the throughput statistic that is used to trigger the throughput 
threshold alert. 



Note: An alert cannot be modified unless it is in the disabled state. Verify that the 
alert is disabled before executing this command. 



Parameters 



This command has the following parameters: 



name 



utilizationType 



The name of a throughput threshold alert as 
defined by the command 
"perf.thresholdAlerts.throughput.addAlert" on 
page 194. 

The type of traffic that triggers the alert. Enter 
the number that corresponds to the desired 
utilization type: 

1 - Transmit Traffic (Tx) 

2 - Receive Traffic (Rx) 

3 - Both (Rx and Tx) 



Command Example 

Root> perf thresholdAlerts throughput setUtilType eportRx 1 
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perf.thresholdAlerts. throughput. SetUtilPercentage 



Syntax 

SetUtilPercentage name utilizationPercentage 

Purpose 

This command sets the throughput utilization percentage that is used to trigger the 
throughput threshold alert. 



Note: An alert cannot be modified unless it is in the disabled state. Verify that the 
alert is disabled before executing this command. 



Parameters 

This command has the following parameters: 

name The name of a throughput threshold alert as 

defined by the command 
"perf.thresholdAlerts.throughput.addAlert" 
on page 194. 

utilizationPercentage The percentage of throughput utilization 

that triggers the alert. This must be entered 
as a number. Accepted values are in the 
range 1 to 100. 



Command Example 

Root> perf thresholdAlerts throughput SetUtilPercentage eportRx 
70 
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perf.thresholdAlerts.throughput.setParams 



Syntax 

setParams name duration interval 

Purpose 

This command sets the duration and interval times for a specified throughput 
threshold alert. This command enables you to configure the alert to be sent if both 
of the following events occur: 

■ The throughput threshold alert value is surpassed for more than the timespan 
specified for the duration parameter. 

■ The duration parameter is surpassed within the time frame specified by the 
interval parameter. 

Parameters 

This command has the following parameters: 

name The name of a throughput threshold alert as 

defined by the command 
"perf.thresholdAlerts.throughput.addAlert" on 
page 194. 

duration The duration time, in minutes, that the 

utilization must exist to trigger the alert. 
Acceptable values are in the range 0 to 
70,560 minutes. Setting this value to zero 
means that the alert is triggered if the specified 
utilization is exceeded at any time. The value 
of this parameter must be equal to or greater 
than the value of the interval parameter. 

interval This sets the interval time in minutes. The 

interval is a fixed length of time. It is not a 
rolling window of time. Acceptable values are 
in the range 0 to 70 , 560 minutes. The value 
of this parameter must be greater than or equal 
to the value of the duration parameter. 
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Command Example 

Root> perf thresholdAlerts throughput SetParams eportRx 1 10 
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perf.thresholdAlerts.throughput.show 

Syntax 

show name 

Purpose 

This command displays the settings for an individual throughput threshold alert. 

Parameters 

This command has the following parameter. 

name The name of a throughput threshold alert as 

defined by the command 
"perf.thresholdAlerts.throughput.addAlert" on 
page 194. 

You can specify all instead of a name, which 
means that all threshold alerts are displayed. 



Note: The output of this command truncates threshold alert names that are longer 
than 51 characters. If you specify lengthy names, you can display the complete name 
by entering the comma-delimited mode using the commaDelim command. 



Command Example 

Root> perf thresholdAlerts throughput show eportRx 



Output Example 



The output from the perf.thresholdAlerts.throughput.show command displays as 
follows. 

Name: 90% Receive Throughput Threshold 

Ports: 5,8,12,20-24 

Utilization Type: Rx 

Utilization Percentage: 90% 

Duration: 15 

Interval: 3 0 

Alert State: Disabled 
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perf.thresholdAlerts. throughput. showUtilTypeTable 



Syntax 

showUtilTypeTable 



Purpose 



This command displays a table of the utilization types that can be used for a 
throughput threshold alert. This table is used for reference only. 



Parameters 

This command has no parameters. 
Command Example 

Root> perf thresholdAlerts throughput showUtilTypeTable 



Output Example 



The output from the perf.thresholdAlerts.throughput.showUtilTypeTable 
command displays as follows. 

NumberUtilization Type 



1 Transmit Traffic (Tx) 

2 Receive Traffic (Rx) 

3 Both (Tx/Rx) 
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perf.traffic 

Syntax 
Purpose 
Parameters 



traffic portNumber 



This command displays port traffic counters for a single port. 



This command has one parameter: 

portNumber Specifies the port number. 

Valid values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 



Command Example 

Root> perf traffic 2 



Output 



The port traffic counter data is displayed as a table that includes the following 
statistics, along with a wrap count for each corresponding counter: 

Port The port number. 

Rx% The received link utilization percentage. 

Tx% The transmitted link utilization percentage. 

RxFrames The number of Fibre Channel Class 2 and Class 3 frames that 
the port has received. 
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TxFrames The number of Fibre Channel Class 2 and Class 3 frames that 
the port has transmitted. 

RxWords The number of 4-byte words in Class 2 and Class 3 frames that 
the port has received. 

Tx Words The number of 4-byte words in Class 2 and Class 3 frames that 
the port has transmitted. 

Output Example 

The output from the perf . traffic command displays as follows. 



Port 2 






Statistic 


Count 


Wrap 


Rx% 


75 


N/A 


Tx% 


30 


N/A 


RxFrames 


2953184 


23 


TxFrames 


1842953 


12 


TxWords 


2953184 


65 


TxWords 


1842953 


32 
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show Commands 

The show branch of the CLI command tree contains commands that display, but 
do not change, stored data values. The displayed output that results from these 
commands is not necessarily identical with the output from the show commands 
that are within the other CLI command tree branches, for example, 
conf ig . port . show. 

The commands in the show branch can by used either by the Administrator or the 
Operator. 
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show.all 

Syntax 

all 

Purpose 

This command displays all configuration and status information available. The 
command results in a sequential display of the output of other CLI show 
commands. This set of show commands returns the full configuration and status 
of the switch and fabric. 

Parameters 

This command has no parameters. 
Command Example 

Root> show all 

Output 

The output of this command is a sequential display of the output of other CLI 
show commands. The commands are displayed in the following order: 

■ show.ip.ethernet 

■ show. system 

■ show, switch 

■ show.port.config 

■ show.frus 

■ config.snmp.show 

■ show, zoning 

■ show.port.state 

■ show.port.info 

■ show.port.technology 

■ show.port.exit 

■ show.loginserver 
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■ show.features 

■ show.security.portbinding 

■ show. security. switchbinding 

■ show.security.fabricbinding 

■ show.openTrunking.config 

■ show. thresholdAlerts. alerts 

■ show.fabric.topology 

■ show. fabric. nodes 
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show.eventLog 

Syntax 

eventLog [clear] 

Purpose 



This command shows the contents of the event log as maintained in NVRAM on 
the director or edge switch. 



Parameters 

This command has one parameter: 



clear This optional parameter causes all reroute log entries to 

be cleared. 



Command Example 

Root> show eventLog 

Output 

The event log data are displayed as a table that includes the following properties: 

Date/Time The date and time when the event occurred. 

Code The event reason code. 

Severity The severity of the event. The values are: 

Ma j or — Unit operational (major failure). 

Minor — Unit operational (minor failure). 

Severe — Unit not operational. 

The causes are either the switch contains no operational 
SBAR cards or the system shuts down due to CTP thermal 
threshold violations. 

Info — Unit operational (information only). 
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FRU The FRU and FRU position, where applicable. 

Event Data The 32-byte hexidecimal description of the event in words. 

Output Example 

The output from the show . eventLog command displays as follows: 

Date/Time Code Severity FRU Event Data 

04/12/01 10:58A 375 Major CTP-0 00010203 04050607 08090A0B 0C0D0E0F 

04/12/01 9:58A 385 Severe CTP-0 00010203 04050607 08090A0B 0C0D0E0F 

04/11/01 7:18P 395 Severe CTP-0 00010203 04050607 08090A0B 0C0D0E0F 
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show.fabric.nodes 

Syntax 

nodes 

Purpose 

This command displays a list of all fabric-attached nodes. 

Parameters 

This command has no parameters. 
Command Example 

Root> show fabric nodes 

Output 

The data is displayed as a table that includes the following properties: 

Domain ID Domain ID of the switch to which the device is 

attached. 

Node WWN The WWN of the fabric attached node. 



Output Example 

The output from the show.fabric.nodes command displays as follows. 

Domain ID Node WWN 



2 12:34:7C:CC:57:86:37:23 

2 98:45:75:25:7B:35:30:34 

2 27 :35 : 3E: 69 : 63 : 34 :22 : 11 

2 29:81:24:74:57:32:48:98 

6 25 :F2 : 35 :7A:25 : 22 : 11 : OB 

18 Fl :23 : 96 :43 : 56 :A3 :AA: 12 

18 45 :4D:2B:22 : 62 : 9B: 19 : 91 
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show.fabric.topology 



Syntax 

topology 

Purpose 

This command displays a text description of the fabric. 

Parameters 

This command has no parameters. 
Command Example 

Root> show fabric topology 



Output 



The features data is displayed as a table that includes the following properties: 

Switch WWN The WWN of the switch at the local end of the 
ISL. 

DID Domain ID of the switch at the local end of the 

ISL. 

OutPrt The port number at the local end of the ISL. 

Remote WWN The WWN of the switch at the remote end of 
the ISL. 

RemDID The domain ID of the switch at the remote end 

of the ISL. 

RemPrt The port number at the remote end of the ISL. 
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Output Example 

The output from the show.fabric.topology command displays as follows. 

Switch WWN DID OutPrt Remote WWN RemDID RemPrt 



02 : 


:30: 


:40 


:32 


:34 


:34: 


:32 


:21 


2 


24 


24 


:45: 


:73 


:49: 


:05 


:43: 


:22: 


:11 


10 


2 




















25 


24 


:45: 


:73 


:49: 


:05 


:43: 


:22: 


:11 


10 


3 




















26 


24 


:45: 


:73 


:49: 


:05 


:43: 


:22: 


:11 


10 


4 


24: 


:45: 


:73 


:49: 


:05 


:43: 


:22 


:11 


10 


2 


02 


:30: 


:40 


:32 : 


:34 


:34: 


:32 


:21 


2 


24 




















3 


02 


:30: 


:40 


:32 : 


:34 


:34: 


:32: 


:21 


2 


25 




















4 


02 


:30: 


:40 


:32 : 


:34 


:34: 


:32 


:21 


2 


26 


21: 


:23 : 


:21 


:25: 


:76 


:43: 


:23 


:21 


10 


7 


02 


:30: 


:40 


:32 : 


:34 


:34: 


:32 


:21 


15 


3 


02 : 


:30: 


:40 


:32 


:34 


:34: 


:32 


:21 


15 


3 


21 


:23 : 


:21 


:25: 


:76 


:43: 


:23 : 


:21 


10 


7 
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show.features 

Syntax 

features 

Purpose 

This command displays a table of all installed feature sets and their states. This 
command provides the same output as the command "config.features.show" on 
page 48. 

Parameters 

This command has no parameters. 
Command Example 

Root> show features 

Output 

The features data is displayed as a table that includes the following properties: 

Installed Feature Set The feature set installed using a feature key. Only 
installed keys are displayed. 

Feature Individual features within each set. In many cases, 

there is only one feature within each feature set. 

State The state of the individual feature. Fabric-wide 

features are displayed as Active/Inactive. 
Switch-centric features are displayed as 
Enabled/Disabled. 
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Output Example 

The output from the show . features command displays as follows: 

Installed Feature Set Feature State 



Open Systems Mgmt Server 
Flex Ports 



SANtegrity 
SANtegrity 
SANtegrity 
Open Trunking 



OSMS 

8 Flex Ports 
Fabric Binding 
Switch Binding 
Enterprise Fabrics 
Open Trunking 



Enabled 

Enabled 

Active 

Enabled 

Active 

Enabled 
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show.frus 



Syntax 



Purpose 



Parameters 



f rus 



This command displays information about all FRUs. 



This command has no parameters. 



Command Example 



Root> show frus 



Output 



The FRU information is displayed as a table that includes the following 
properties: 

FRU 



Position 
State 



Serial Num 

Part Num 
Beaconing 
Pwr On Hrs 



The FRU name. This property may show Unknown or 
Not Installed if the FRU is not installed. 

The relative position of the FRU, that is, its slot. 

The state of the FRU. Values are: 

■ Active — the current module is active. 

■ Backup — this module is not currently being used, but 
it is available for immediate failover. 

■ Failed — the current module is failed. 

The serial number of the FRU. (This field is blank for the 
power supply modules of the Edge Switch 2/24.) 

The part number of the FRU. 

The beaconing state of the FRU (on or off). 

The power-on hours value for the FRU. 
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Output Example 

The output from the show . f rus command displays as follows: 

FRU Position State Serial Num Part Num Beacon Pwr On Hrs 



CTP 


0 


Active 


470- 


000399 


-700 


123456789 


Off 


800 


CTP 


1 


Backup 


470- 


000399 


-700 


223456789 


On 


2801 


SBAR 


0 


Active 


470- 


000399 


-700 


223456789 


Off 


2801 


SBAR 


1 


Failed 


470- 


000399 


-700 


223456789 


Off 


2801 


FPM 


1 


Active 


470- 


000399 


-700 


223456789 


Off 


2801 


FPM 


3 


Active 


470- 


000399 


-700 


223456789 


Off 


831 


UPM 


4 


Active 


470- 


000399 


-700 


223456789 


Off 


831 


Power 


0 


Active 


470- 


000399 


-700 


223456789 


Off 


831 


Fan 


0 


Active 


470- 


000399 


-700 


223456789 


Off 


831 



218 



CLI Reference Guide for Directors and Edge Switches 



show.ip.ethernet 



show.ip.ethernet 

Syntax 

ethernet 

Purpose 

This command displays Ethernet attributes. 

Parameters 

This command has no parameters. 
Command Example 

Root> show ip ethernet 

Output 

The Ethernet attributes data are displayed as a table that includes the following 
properties: 

IP Address The IP address for the Ethernet adapter as set in the 

conf ig . ip . ethernet command. 

Gateway The gateway address for the Ethernet adapter as set in the 

Address conf ig . ip . ethernet command. 

Subnet Mask The subnet mask for the Ethernet adapter as set in the 
conf ig . ip . ethernet command. 



Output Example 

The output from the show . ip . ethernet command displays as follows: 

LAN Information 

IP Address: 144.49.10.15 

Gateway Address : 144.49.10.1 

Subnet Mask: 255.255.255.0 
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show.linklncidentLog 



Syntax 
Purpose 



linklncidentLog [clear] 



This command shows the contents of the link incident log on the director or 
switch. 



Note: If the switch is restarted (as occurs during IPL, IML, configuration reset, feature 
key installation, or firmware load) or is power cycled, the information in the link 
incident log is lost. 



This command has one parameter. 

clear This optional parameter causes all link incident 

log entries to be cleared. 



Command Example 

Root> show linklncidentLog 



Parameters 



Output 



The event log data are displayed as a table that includes the following properties: 

Date/Time The date and time when the event occurred. 

Port The number of the port where the link incident 

occurred. 

Link Incident An ASCII string describing the link incident 
Event event. 
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Output Example 

The output from the show.linklncidentLog command displays as follows: 

Date / Time Port Link Incident Event 



02/27/03 01:28P 20 Not Operational primitive sequence. 

02/27/03 01:28P 4 Primitive sequence timeout. 

02/27/03 01:27P 62 Not Operational primitive sequence. 

02/27/03 01:27P 62 Invalid primitive seq received. 
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show, log i nServer 



Syntax 
Purpose 



loginServer 



This command displays information from the login server database for devices 
attached to this switch. 



Note: It is possible to have more than one device per port for any public loop devices 
attached to an FL Port. 



Parameters 



This command has no parameters. 



Command Example 



Output 



Root> show loginServer 



The device information is displayed as a table that includes the following 
properties: 

Port The port number where the device is attached. 

BB Crdt The maximum number of remaining frames that can be 

transmitted without causing a buffer overrun condition at 
the receiver. 

RxFldSz The buffer-to-buffer receive data field size from the 

FLOGI received from the attached N_Port. 

COS The class of service (for example, 1; 2; 3; 4; 5; 6; F; 1,2; 

2,3). 

Port Name The port World Wide Name of the attached device. 

Node Name The node World Wide Name of the attached device. 
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Output Example 

The output from the show . loginServer command displays as follows. 

Port BB Crdt RxFldSz COS Port Name Node Name 



0 


10 


2, 


3 


00 


11 


22 


33 


44 


55 


00 


77 


20 


11 


22 


33 


44 


55 


66 


77 


1 


10 


2 




00 


11 


22 


33 


44 


55 


00 


78 


20 


11 


22 


33 


44 


55 


66 


78 


4 


10 


2 , 


3 


00 


11 


22 


33 


44 


55 


00 


79 


20 


11 


22 


33 


44 


55 


66 


79 


7 


10 


2, 


3 


00 


11 


22 


33 


44 


55 


00 


80 


20 


11 


22 


33 


44 


55 


66 


80 


8 


10 


2 




00 


11 


22 


33 


44 


55 


00 


81 


20 


11 


22 


33 


44 


55 


66 


81 


10 


10 


2, 


3 


00 


11 


22 


33 


44 


55 


00 


82 


20 


11 


22 


33 


44 


55 


66 


82 


11 


10 


2, 


3 


00 


11 


22 


33 


44 


55 


00 


83 


20 


11 


22 


33 


44 


55 


66 


83 


12 


10 


3 




00 


11 


22 


33 


44 


55 


00 


84 


20 


11 


22 


33 


44 


55 


66 


84 


13 


10 


2, 


3 


00 


11 


22 


33 


44 


55 


00 


85 


20 


11 


22 


33 


44 


55 


66 


85 


15 


10 


2, 


3 


00 


11 


22 


33 


44 


55 


00 


86 


20 


11 


22 


33 


44 


55 


66 


86 
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show.nameServer 



Syntax 
Purpose 



nameServer 



This command displays information from the name server database for devices 
attached to this switch. 



Note: It is possible to have more than one device per port for any public loop devices 
attached to an FL Port. 



Parameters 



This command has no parameters. 



Command Example 



Output 



Root> show nameServer 



The device information data is displayed as a table that includes the following 
properties: 

Type The type (N, NL, F/NL, F, FL, E, B). 

Port Id The 24-bit Fibre Channel address. 

Port Name The port World Wide Name of the attached device. 

Node Name The node World Wide Name of the attached device. 

COS The class of service (for example, 1; 2; 3; 4; 5; 6; F; 1,2; 

2,3). 

FC4 Types The FC4 types registered for this device. One or more 

numbers display in this field. 

The numbers in this field correspond to the list at the 
bottom of the table. 
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Output Example 

The output from the show . nameServer command displays as follows. 

Type Port Id Port Name Node Name COS FC4 Types 



N 


010400 


00 


11 


22 


33 


44 


55 


66 


77 


20 


11 


22 


33 


44 


55 


66 


77 


2 


3 


2 


N 


010500 


00 


11 


22 


33 


44 


55 


66 


78 


20 


11 


22 


33 


44 


55 


66 


78 


2 


3 


0 


N 


010600 


00 


11 


22 


33 


44 


55 


66 


79 


20 


11 


22 


33 


44 


55 


66 


79 


2 


3 


2 


N 


010700 


00 


11 


22 


33 


44 


55 


66 


80 


20 


11 


22 


33 


44 


55 


66 


80 


2 




2 


N 


010800 


00 


11 


22 


33 


44 


55 


66 


81 


20 


11 


22 


33 


44 


55 


66 


81 


3 




2 


N 


010900 


00 


11 


22 


33 


44 


55 


66 


82 


20 


11 


22 


33 


44 


55 


66 


82 


3 




2 


N 


010C00 


00 


11 


22 


33 


44 


55 


66 


83 


20 


11 


22 


33 


44 


55 


66 


83 


2 


3 


2 


N 


010D00 


00 


11 


22 


33 


44 


55 


66 


84 


20 


11 


22 


33 


44 


55 


66 


84 


2 


3 


2 


N 


010E00 


00 


11 


22 


33 


44 


55 


66 


85 


20 


11 


22 


33 


44 


55 


66 


85 


2 




5 


N 


010F00 


00 


11 


22 


33 


44 


55 


66 


86 


20 


11 


22 


33 


44 


55 


66 


86 


2 




4 


N 


011200 


00 


11 


22 


33 


44 


55 


66 


87 


20 


11 


22 


33 


44 


55 


66 


87 


2 


3 


2 


N 


011300 


00 


11 


22 


33 


44 


55 


66 


88 


10 


11 


22 


33 


44 


55 


66 


88 


2 


3 


2 



FC4 Types 

0: ISO/IEC 8802-2 LLC 

1: ISO/IEC 8802-2 LLC /SNAP 

2: SCSI-FCP 

3: SCSI-GPP 

4: IPI-3 Master 

5: IPI-3 Slave 

6: IPI-3 Peer 

7: CP IPI-3 Master 

8: CP IPI-3 Slave 

9: CP IPI-3 Peer 

10: SBCCS-Channel 

11: SBCCS-Control Unit 

12: FC-SB-2 Channel to Control Unit 

13: FC-SB-2 Control Unit to Channel 

14 : Fibre Channel Service 

15: FC-FG 

16: FC-SW 

17 : FC-AL 

18 : SNMP 

19: HIPPI-FP 

20: Vendor Unique 
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show.nameServerExt 



Syntax 

names erverExt 

Purpose 

This command displays extended information from the name server database for 
devices attached to this switch. The command provides symbolic nameserver 
information, as well as the same information as the show . nameServer 
command. Multiple devices per port are possible for any public loop device 
attached to an FL Port. 



Note: Because it contains symbolic nameserver information that can be lengthy, the 
CLI output wraps several times per node. For this reason, this command is supported 
only in comma-delimited mode. 



Parameters 

This command has no parameters. 
Command Example 

Root> show nameServerExt 

Output 

The device information data is displayed as a table that includes the following 
properties: 

Type The type (N, NL, F/NL, F, FL, E, B). 

Port Id The 24-bit Fibre Channel address. 

Port Name The port World Wide Name of the attached device. 

Node Name The node World Wide Name of the attached device. 

COS The class of service (for example, 1; 2; 3; 4; 5; 6; F; 

1,2; 2,3). 
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FC4 Types The FC4 types registered for this device. One or more 

numbers display in this field. The numbers in this field 
correspond to the list in the output example for 
"show.nameServer" on page 224. 

SymNodeName 255-character representation of the Symbolic Node Name. 

SymPortName 255-character representation of the Symbolic Port Name. 



Output Example 

The output from the show . nameServerExt command displays as follows. 

Type, Port Id, Port Name, Node Name, COS, FC4 Types, SymNodeName, SymPortName, 
N, 010400, 00:11:22:33:44:55:00:77, 2 0:11:22:33:44:55:66:77, 2-3, 2, Node Name A, 
Port Name A, N, 010500, 00:11:22:33:44:55:01:77, 20:11:22:33:44:55:66:77, 2-3, 0, 
This Is Symbolic Node Name B, Symbolic Port Name B Is Slightly Longer N, 10600, 
00:11:22:33:44:55:66:02, 2 0:11:22:33:44:55:66:77, 2-3, 2, , , FL , 000001, 
00:11:22:33:44:55:66:03, 2 0:11:22:33:44:55:66:77, 2, 0, Loop Node 1 , Loop Port 7 
FL, 000002, 00:11:22:33:44:55:66:04 2 0:11:22:33:44:55:66:77, 3, 2, Loop Node 2 , 
Loop Port 7, 
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show.openTrunking.config 



Syntax 

Purpose 

Parameters 



conf ig 



This command displays the trunking configuration for all ports. 



This command has no parameters. 



Command Example 



Output 



show openTrunking config 



The device information data is displayed as a table that includes the following 
properties: 



Unresolved 
Congestion 

Backpressure 

Low BB Credit 
Threshold Table 



Congestion 
Threshold Table 



The current enabled/disabled state of the 
unresolved congestion trunking feature. 

The current enabled/disabled state of the 
backpressure trunking feature. 

The current threshold setting of the low BB credit 
threshold trunking feature shown as a percentage. 
If this value is configured to be the default, 
(default ) is displayed alongside the threshold 
value. The default value is 75%. 

A table mapping each port number on the switch to 
a corresponding threshold setting. The threshold is 
listed as a percentage. If this value is configured to 
be the default, ( de f aul t ) is displayed alongside 
the threshold value. The default value is 60% 
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Output Example 

The output from the show . openTrunking . conf ig command displays as 
follows. 

Unresolved Congestion: Enabled 

Backpressure: Disabled 

Low BB Credit Threshold (%) : 50 (default) 
Port Threshold % 



1 60 (default) 

2 69 

3 60 (default) 

4 60 (default) 

5 90 
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show.openTrunking.reroutelog 

Syntax 

reroutelog [clear] 

Purpose 

This command displays the trunking reroute log information. 

Note: If the switch is restarted (as occurs during IPL, IML, configuration reset, feature 
key installation, or firmware load) or is power cycled, the information in the Open 
Trunking Re-route Log is lost. 

Parameters 

This command has one parameter: 

clear This optional parameter causes all reroute log 

entries to be cleared. 

The clear parameter also clears the log 
entries for the HAFM. 

Command Example 

show opentrunking reroutelog 
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Output 

The device information data is displayed as a table that includes the following 
properties: 

Date/Time The date/time when the rerouting event 

occurred. 

Rev The port associated with the flow that was 

rerouted. 

Dom The target domain associated with the flow that 

was rerouted. 

Old The exit port number on this switch that the 

flow used to get to the target domain. 

New The exit port number on this switch that the 

flow now uses to get to the target domain. 

Output Example 

The output from the show . opentrunking . reroutelog command displays 
as follows. 

Date/Time RcvPort Dom OldExit NewExit 

04/12/01 10:58A 63 2 41 42 

03/23/02 12:01P 4 3 35 36 
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show.port.config 



Syntax 

Purpose 

Parameters 



conf ig 



This command shows the port configuration for all ports. 



This command has no parameters. 
Command Example 



Output 



Root> show port config 



The port configuration attributes are displayed as a table that includes the 
following properties: 



Port 
Name 

Blocked 

Ext Dist 

FAN 
Type 
Speed 



The port number. 

The name of the port as set in the config . port . name 
command. 

The blocked state of the port as set in the 
config . port . blocked command. 

The extended distance state as set in the 

conf ig .port . extDist command. (This does not 

apply to the Edge Switch 2/24.) 

The configured fabric address notification (FAN) state. 
(Edge Switch 2/24 only.) 

The port type as set in the config . port . type 
command. 

The port speed as set in the conf ig .port . speed 
command. 
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Output Example 

The output from the show . port . conf ig command displays as follows: 



Port 


Name 




Blocked 


Ext Dist 


Type 


Speed 


0 


Port 


1 


false 


false 


f Port 


1 Gb/sec 


1 


Port 


2 


true 


true 


f Port 


1 Gb/sec 


2 


Port 


3 


false 


false 


gPort 


1 Gb/sec 


3 


Port 


4 


false 


false 


f Port 


2 Gb/sec 


4 


Port 


5 


true 


true 


f Port 


2 Gb/sec 


5 


Port 


6 


false 


false 


f Port 


2 Gb/sec 


6 


Port 


7 


true 


true 


f Port 


1 Gb/sec 


7 


Port 


8 


false 


false 


f Port 


Negotiate 


8 


Port 


9 


false 


true 


f Port 


1 Gb/sec 


9 


Port 


A 


false 


false 


f Port 


1 Gb/sec 


10 


Port 


B 


false 


false 


f Port 


2 Gb/sec 


11 


Port 


C 


false 


false 


f Port 


2 Gb/sec 


12 


Port 


D 


false 


false 


f Port 


1 Gb/sec 


13 


Port 


E 


false 


false 


f Port 


1 Gb/sec 


14 


Port 


F 


false 


false 


f Port 


1 Gb/sec 


15 


Port 


X 


false 


false 


f Port 


1 Gb/sec 
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show.port.exit 



Syntax 

exit destDomainID sourcePort 

Purpose 

This command displays the exit port from a source port to a given destination 
domain. This command shows the Preferred Path configuration. 

Use all for one of the command's parameters to display all configured and 
actual exit ports for either the destination domain ID or the specified source Port. 
You cannot specify all for both parameters. If the destination domain is set to 
all, then all paths from the specified source port are displayed. If the source port 
is set to all, the output shows all source port paths to the specified domain. 

Parameters 

This command has the following parameters: 

destDomciinld Specifies the destination domain ID. Valid 

domain IDs are in the range 1-31, or, use all 
to show all exit ports to and from the source port 
specified in the sourcePort parameter. 

sourcePort Specifies the number of the source port. Valid 

port numbers values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 

Or, you can specify all to show all exit ports 
to the destination domain ID specified for the 
destDomainld parameter. 
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Output 



The output from show.port.exit includes the following parameters: 

Destination The destination domain ID to which a preferred 

Domain path has been configured. This is displayed only 

if the destination domain parameter is set to 

all. 



Source Port The source port for which a preferred path to the 

specified destination domain ID is specified. 
This is displayed only if the source port 
parameter is set to all. 

Exit Port This is the actual exit port being used for the 

given path. The value No Domain displays 
when the destination domain doesn't exist in the 
fabric. The value No Source displays when 
the source port is in an offline state. The value 
Fabric Building displays when the fabric 
is still building. 



Command and Output Examples 

The following examples show the output returned by the three methods of 
specifying the show.port.exit command. 

Output with single values for both parameters 

Root> show port exit 21 10 
Exit Port: 45 

Output with destDomainld set to all 

Root> show port exit all 15 
Destination Domain Exit Port 



1 23 

2 No Domain 

3 23 

31 No Domain 
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Output with sourcePort set to all 

Root> show port exit 1 all 
Source Port Exit Port 



0 No Source 

1 5 

2 No Source 

3 6 
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show. port, info 



Syntax 

Purpose 

Parameters 



info 



This command displays port information for all ports. 



This command has no parameters. 
Command Example 



Output 



Root> show port info 



The port information data is displayed as a table that includes the following 
properties: 

Port 
WWN 
OpSpeed 



SpeedCap 



The port number. 

The World Wide Name of the port. 

The current operating speed (1.0625 Gbps, 2 . 125 
Gbps, or Not Established). 

The current transceiver capability speed 
(1 . 0 62 5 or 2 . 12 5 Gbps). 



Output Example 

The output from the show . port . info command displays as follows. 



Port 


WWN 














OpSpeed 


SpeedCap 


0 


10 : 


00 


80 


00 


11 


22 


33 


44 


1 


Gb/sec 


2 


Gb/sec 


1 


10 : 


00 


80 


01 


11 


22 


33 


44 


1 


Gb/sec 


2 


Gb/sec 


2 


10 : 


00 


80 


02 


11 


22 


33 


44 


1 


Gb/sec 


2 


Gb/sec 


3 


10 : 


00 


80 


03 


11 


22 


33 


44 


1 


Gb/sec 


2 


Gb/sec 


4 


10 : 


00 


80 


04 


11 


22 


33 


44 


2 


Gb/sec 


2 


Gb/sec 


5 


10 : 


00 


80 


05 


11 


22 


33 


44 


2 


Gb/sec 


2 


Gb/sec 


6 


10 : 


00 


80 


06 


11 


22 


33 


44 


2 


Gb/sec 


2 


Gb/sec 


7 


10 : 


00 


80 


07 


11 


22 


33 


44 


2 


Gb/sec 


2 


Gb/sec 
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8 


10 


00 


80 


08 


11 


22 


33 


44 


2 


Gb/sec 


2 


Gb/sec 


9 


10 


00 


80 


09 


11 


22 


33 


44 


2 


Gb/sec 


2 


Gb/sec 


10 


10 


00 


80 


10 


11 


22 


33 


44 


1 


Gb/sec 


2 


Gb/sec 


11 


10 


00 


80 


11 


11 


22 


33 


44 


1 


Gb/sec 


2 


Gb/sec 


12 


10 


00 


80 


12 


11 


22 


33 


44 


1 


Gb/sec 


2 


Gb/sec 


13 


10 


00 


80 


13 


11 


22 


33 


44 


1 


Gb/sec 


2 


Gb/sec 


14 


10 


00 


80 


14 


11 


22 


33 


44 


1 


Gb/sec 


2 


Gb/sec 


15 


10 


00 


80 


15 


11 


22 


33 


44 


1 


Gb/sec 


2 


Gb/sec 
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show. port, nodes 



Syntax 

nodes portNumber 

Purpose 

This command displays the loop node list for a specified port. 

Parameters 

This command has one parameter: 

portNumber Specifies the port number. 

Valid values are: 

0-11 for the Edge Switch 2/12 

0-23 for the Edge Switch 2/24 

Command Example 

Root> show port nodes portNumber 



Output 



The port data is displayed as a table that includes the following properties: 

FC Addr The Fibre Channel address of nodes attached to this 

port. Private devices are assigned address strings of 
0000 followed by the two-digit hexadecimal 
Arbitrated Loop Physical Address (ALPA), instead 
of the 6-digit hexadecimal number presented for 
public devices. 

Attached WWN The WWN of nodes attached to this port, or the 

string NOT LOGGED IN for a private loop device. 

Class The Class value for public devices. This field is left 

blank for private devices. 

Data Field Size The Data Field Size value for public devices. This 

field is left blank for private devices. 
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Output Example 

The Data Field Size value for public devices. This field is left blank for private 
devices. 

FC Addr Attached WWN Class Data Field Size 



610A01 


33:00:00:00:00: 


: 00 : 


:00: 


: 03 


1 


2112 


610A02 


33:00:00:00:00: 


: 00 : 


: 00 : 


: 04 


1 


2112 


610A04 


33:00:00:00:00: 


: 00 : 


:00: 


: 05 


1 


2112 


610A08 


33:00:00:00:00: 


: 00 : 


:00: 


: 02 


1 


2112 


610A0F 


33:00:00:00:00: 


: 00 : 


: 00 : 


: OA 


1 


2112 


610A10 


33:00:00:00:00: 


: 00 : 


: 00 : 


: 10 


1 


2112 


000017 


NOT LOGGED IN 












000018 


NOT LOGGED IN 












00001B 


NOT LOGGED IN 













If no nodes are on the loop, a message displays saying that no loop nodes are on 
the port. 
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show.port.status 

Syntax 

status 

Purpose 

This command displays port status for all ports. 

Parameters 

This command has no parameters. 
Command Example 

Root> show port status 

Output 

The port status data is displayed as a table that includes the following properties: 

Port The port number. 

State The port state. For example: 

■ Segmented E_Port 

■ Invalid Attachment 

■ Not Installed 

■ Online 

■ Offline 

■ Not Operational 

■ No Light 

■ Testing 

■ Port Failure 

■ Link Reset 

■ Inactive 
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Type 



Attached WWN 

Beaconing 
Reason 



The operational port type. 

If the configured port type is F_Port or E_Port, this 
value will match the configured type. 

If the configured type is G_Port, this value can be 
E_Port, F_Port, or G_Port, depending on what is 
connected to the port. 

On the Edge Switch 2/24, if the configured port type 
is Fx_Port, the operational port type can include 
FL_Port in addition to the values noted above for 
F_Port. If the configured port type is Gx_Port, then 
the operational port type can include FL_Port in 
addition to the values noted above for G_Port. 

The World Wide Name of the device or switch 
attached to the port, if one is attached. 

The beaconing state for the port (true or false). 

An optional message number that indicates if the port 
has a segmented ISL or if a port binding violation has 
occurred, or if the part is inactive. 

The message description for this message number is 
provided at the bottom of the table. 

If the operational state is Segmented E_Port, 
only the following messages can be generated: 

■ 01 Segment Not Defined 

■ 02 Incompatible Operating Parameters 

■ 03 Duplicate Domain ID(s) 

■ 04 Incompatible Zoning Configurations 

■ 05 Build Fabric Protocol Error 

■ 06 No Principal Switch 

■ 07 No Response from Attached Switch 

■ 08 ELP Retransmission Failure Timeout 
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If the operational state is Invalid Attachment, 
only the following messages can be generated: 

■ 09 Unknown 

■ 10 ISL connection not allowed on this port 

■ 11 ELP rejected by the attached switch 

■ 12 Incompatible switch at other end of the ISL 

■ 13 External loopback adapter connected to the 
port 

■ 14 N_Port connection not allowed on this port 

■ 15 Non-HP switch at other end of the ISL 

■ 16 ISL connection not allowed on this port 

■ 17 ISL connection not allowed to external Fabrics 

■ 18 Port binding violation — unauthorized WWN 

■ 19 Unresponsive Node Connected to Port 

■ 20 Incompatible security attributes 

■ 21 Fabric Binding violation 

■ 22 Authorization failure 

■ 23 Switch Binding violation 

If the operational state is Inactive only the 
following messages can be generated: 

■ 24 Inactive - RC 0 

■ 25 No Serial Number 

■ 26 Feature Not Enabled 

■ 27 Switch Speed Conflict 
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Output Example 

The output from the show . port . status command displays as follows. 



Port State 



Type Attached WWN 



Beaconing Reason 



0 


Online 


f Port 


10 


00 


80 


00 


11 


22 


33 


44 


Off 


1 


Online 


gPort 


10 


00 


80 


00 


11 


22 


33 


45 


On 


2 


No Light 


f Port 


10 


00 


80 


00 


11 


22 


33 


55 


On 


3 


Offline 


ePort 


10 


00 


80 


00 


11 


22 


33 


00 


Off 


4 


Online 


gPort 


10 


00 


80 


00 


11 


22 


33 


57 


Off 


5 


Port Failure 


f Port 


10 


00 


80 


00 


11 


22 


33 


46 


Off 


6 


Link Reset 


gPort 


10 


00 


80 


00 


11 


22 


33 


63 


Off 


7 


Segmented E_Port 


ePort 


10 


00 


80 


00 


11 


22 


33 


47 


Off 


8 


Online 


ePort 


10 


00 


80 


00 


11 


22 


33 


88 


Off 


9 


Offline 


f Port 


10 


00 


80 


00 


11 


22 


33 


49 


Off 


10 


Inactive 


ePort 


10 


00 


80 


00 


11 


22 


33 


50 


Off 


11 


Online 


f Port 


10 


00 


80 


00 


11 


22 


33 


53 


Off 


12 


No Light 


f Port 


10 


00 


80 


00 


11 


22 


33 


56 


Off 


13 


Online 


f Port 


10 


00 


80 


00 


11 


22 


33 


59 


Off 


14 


Invalid Attachment 


f Port 


10 


00 


80 


00 


11 


22 


33 


64 


Off 


15 


Online 


f Port 


10 


00 


80 


00 


11 


22 


33 


66 


Off 



Duplicate Domain ID ( s ) 
Switch Speed Conflict 

ISL connection not allowed on this port 
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show.port.technology 



Syntax 

Purpose 

Parameters 



technology 



This command shows the port technology information for all ports. 



This command has no parameters. 



Command Example 



Output 



Root> show port technology 



The port technology data is displayed as a table that includes the following 
properties: 



Port 

Connectr 
Transcvr 
Distance 
Media 



The port number. 

The port connector type (LC, MT_RJ, MU, 
Internal). 

The transceiver type (Long LC, Short, Short 
OFC, Long LL, Long Dist). 

The distances supported (Short, Intermediate, 
Long, Very Long). 

The media type (M-M 62.5um, M-M 50um, 
M-M 50,62.5um, S-M 9um, Copper). 
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Output Example 

The output from the show . port . technology command displays as follows: 



Port Connectr Transcvr Distance Media 



o 


LC 




Long 


LC 


Long 


M-M 


50um 


1 


LC 




Long 


LC 


Long 


M-M 


50um 


2 


LC 




Long 


LC 


Long 


M-M 


5 Oum 


3 


MT_ 


_RJ 


Long 


LC 


Long 


M-M 


50um 


4 


MT_ 


_RJ 


Long 


LC 


Long 


M-M 


5 Oum 


5 


MT 


_RJ 


Long 


LC 


Long 


M-M 


5 Oum 


6 


LC 




Long 


LC 


Long 


M-M 


5 Oum 


7 


LC 




Long 


LC 


Long 


M-M 


5 Oum 


8 


LC 




Long 


LC 


Long 


M-M 


5 Oum 


9 


LC 




Long 


LC 


Long 


M-M 


5 Oum 


10 


LC 




Long 


LC 


Long 


M-M 


5 Oum 


11 


LC 




Long 


LC 


Long 


M-M 


5 Oum 


12 


LC 




Long 


LC 


Long 


M-M 


5 Oum 


13 


LC 




Long 


LC 


Long 


M-M 


5 Oum 


14 


LC 




Long 


LC 


Long 


M-M 


5 Oum 


15 


LC 




Long 


LC 


Long 


M-M 


5 Oum 
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show.preferredPath.showPath 



Syntax 

showPath destDomainID sourcePort 

Purpose 

This command displays the specified Preferred Path configuration and the actual 
path used by the system. The output shows both the exit port, as configured for the 
Preferred Path feature, and the actual exit port currently being used for traffic. 

Use all for one of the command's parameters to display all configured and actual 
exit ports for either the destination domain ID or the specified source Port. You 
cannot specify all for both parameters. If the destination domain is set to all, all 
paths from the specified source port are displayed. If the source port is set to all, 
the output shows all source port paths to the specified domain. 

Parameters 

This command has the following parameters: 

destDomainld Specifies the destination domain ID. Valid 
domain IDs are in the range 1-31 or all, 
which shows all paths to and from the source 
port specified in the sourcePort parameter. 

sourcePort Specifies the number of the source port. Valid 

port numbers values are: 

0-11 for the Edge Switch 2/12 

0-15 for the Edge Switch 2/16 

0-23 for the Edge Switch 2/24 

0-31 for the Edge Switch 2/32 

0-63 for the Director 2/64 

0-127 and 132-143 for the Director 2/140 

Or, you can specify al 1 to show all paths to the 
destination domain ID specified for the 
destDomainld parameter. 
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Output 



The output from show.preferredPath.showPath includes the following parameters: 



Destination 
Domain 



Source Port 



Preferred Exit 
Port 



Actual Exit Port 



The destination domain ID to which a preferred 
path has been configured. This is displayed only 
if the destination domain parameter is set to 
all. 

The source port for which a preferred path to the 
specified destination domain ID is specified. 
This is displayed only if the source port 
parameter is set to all. 

The configured Preferred Path exit port. This 
value can be any port number, or blank to 
indicate that no Preferred Path has been 
configured. 

This is the actual exit port being used for the 
given path. 



Command and Output Examples 

The following examples show the output returned by the three methods of 
specifying the show.preferredPath.showPath command. 

Single values for both parameters 

Root> show pref erredPath showPath 21 10 
Preferred Path State: Enabled 
Preferred Exit Port: Not Configured 
Actual Exit Port: 45 

destDomainld set to all 

Root> show pref erredPath showPath all 15 
Preferred Path State: Enabled 

Destination Domain Preferred Exit Port Actual Exit Port 



1 23 23 

3 24 No Path 

4 23 23 

17 12 No Source 
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sourcePort set to all 



Root> show pref erredPath showPath 1 all 
Preferred Path State: Enabled 

Source Port Preferred Exit Port Actual Exit Port 



0 2 No Source 

2 5 5 

3 17 No Path 
22 5 6 
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show.security.fabricBinding 



Syntax 

f abricBinding 

Purpose 

This command displays the fabric binding configuration saved on the fabric. The 
command performs the same function as 

conf ig . security . f abricBinding . showActive command. 

Parameters 

This command has no parameters. 
Command Example 

Root> show security f abricBinding 

Output 

The fabric binding configuration data is displayed as a table that includes the 
following properties: 

Domain ID The domain ID of the Fabric Binding 

Membership List (FBML) member. Valid 
domain ID's range from 1 to 239. 

WWN The world wide name (WWN) of the FBML 

member in colon-delimited hexadecimal 
notation. 

Attachment Indicates whether the FBML member is Local, 

Status Attached, or Unattached. For more information, 

see "Fabric Binding Membership Terminology" 

on page 65. 
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Output Example 

The output from the show.security.fabricBinding command displays as follows. 

Domain 1 (20 : 30 : 40 : 50 : 60 : 70 : 8F : 1A) (Local) 

Domain 3 (00:11:22:33:44:55:66:77) (Unattached) 

Domain 2 ( 88 : 99 : AA: BB : CC : DD : EE : FF) (Attached) 

Domain 14 ( 11 : 55 : 3 5 : 45 : 24 : 78 : 98 : FA) (Attached) 
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show.security.portBinding 

Syntax 

portBinding 

Purpose 

This command shows the port binding configuration for all ports. 

Parameters 

This command has no parameters. 
Command Example 

Root> show security portBinding 

Output 

The port binding configuration data is displayed as a table that includes the 
following properties: 

Port The port number. 

WWN Binding The state of port binding for the specified 

port (active or inactive). 

Bound WWN The WWN of the device that is bound to the 

specified port. If this field is blank, no device 
is bound to the specified port. 
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Output Example 

The output from the show . security . portBinding command displays as 
follows: 



Port WWN Binding Bound WWN 



0 


Active 


AA: 


: 00 : 


: AA: 


: 00 : 


: AA: 


: 00 : 


: AA: 


: 00 


1 


Inactive 


00 : 


: 00 : 


: 00 : 


: 00 : 


: 00 : 


: 00 : 


: 00 : 


; 00 


2 


Inactive 


CC: 


:33: 


:44: 


:55: 


:CC: 


:33 : 


: 44 : 


:55 


3 


Active 


00 : 


:00: 


:00: 


:00: 


: 00 : 


:00: 


:00: 


:00 


4 


Inactive 


00: 


:00: 


:00: 


:00: 


: 00 : 


: 00 : 


:00: 


:00 


5 


Inactive 


00: 


:00: 


:00: 


:00: 


: 00 : 


: 00 : 


:00: 


:00 


6 


Inactive 


00: 


:00: 


:00: 


:00: 


: 00 : 


:00: 


:00: 


:00 


7 


Inactive 


00 : 


:00: 


:00: 


:00: 


: 00 : 


: 00 : 


:00: 


:00 


8 


Inactive 


00: 


:00: 


:00: 


:00: 


: 00 : 


: 00 : 


:00: 


:00 


9 


Inactive 


00: 


:00- 


:00: 


:00: 


: 00 : 


: 00 : 


:00: 


: 00 


10 


Inactive 


00 : 


:00: 


:00: 


:00: 


: 00 : 


: 00 : 


:00: 


:00 


11 


Inactive 


00 : 


:00: 


:00: 


:00: 


: 00 : 


:00: 


:00: 


:00 


12 


Inactive 


00: 


:00- 


:00: 


:00: 


: 00 : 


: 00 : 


:00: 


: 00 


13 


Inactive 


00 : 


:00: 


:00: 


:00: 


: 00 : 


: 00 : 


:00: 


:00 


14 


Inactive 


00: 


:00: 


:00: 


:00: 


: 00 : 


: 00 : 


:00: 


: 00 


15 


Inactive 


00: 


:00: 


:00: 


:00: 


: 00 : 


: 00 : 


:00: 


:00 
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show.security. switch Binding 



Syntax 

switchBinding 

Purpose 

This command displays the switch binding configuration. 

Parameters 

This command has no parameters. 
Command Example 

Root> show security switchBinding 



Output 



The switch binding configuration data is displayed as a table that includes the 
following properties: 

Switch Binding State The switch binding state, which can 

have the following values: 

Disabled, Enabled and 
Restricting F_Ports, 

Enabled and Restricting 
E_Ports, or 

Enabled and Restricting 
All Ports 

Switch Binding Membership List The active Switch Binding 

Membership List. 
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Output Example 

The output from the show . security . switchBinding command displays 
as follows: 

Switch Binding State: Enabled and Restricting E Ports 
00 : 11 :22 : 33 :44 : 55 : 66 : 77 
88:99: AA : BB : CC : DD : EE : FF 
11:55:35:45:24:78:98:FA 
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show.switch 



Syntax 



Purpose 



Parameters 



switch 



This command displays switch attributes. 



This command has no parameters. 



Command Example 



Root> show switch 



Output 



The switch attributes data is displayed as a table that includes the following 
properties: 



State 



BB Credit 



R A TOV 



E D TOV 



Preferred Domain Id 



Switch Priority 



The state of the switch. For example: 

■ online 

■ offline 

The BB_Credit as set in the 

conf ig . switch . bbCredit command. 

(This does not apply to the Edge Switch 2/24. 

The R_A_TOV as set in the 

conf ig . switch . raTov command. 

The E_D_TOV as set in the 

conf ig . switch . edTov command. 

The domain ID as set in the 

conf ig . switch . domainld command. 

The switch priority as set in the 

conf ig . switch . priority command. 
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Speed 

Rerouting Delay 
Operating Mode 



The switch speed as set in the 

conf ig . switch . speed command. (This 

does not apply to the Edge Switch 2/24.) 

The rerouting delay as set in the 
conf ig . switch . rerouteDelay 
command. 

The operating mode (Open Systems or S/390). 

This attribute cannot be configured through the 
CLI. 



Note: The Operating Mode parameter is 
equivalent to the Management Style parameter of 
the HAFM interface. The S/390 Mode is 
equivalent to the FICON management style on 
the HAFM. The Open Systems mode is equivalent 
to Open Systems management style for the 
HAFM. 



Interop Mode 
Active Domain Id 

World Wide Name 
Insistent Domain Id 

Domain RSCN 

Zoning RSCN 

FC Address Domain Id 



The interoperability mode as set in the 
conf ig . switch . interopMode 
command. 

The active domain ID of the switch. 

This ID may or may not be the same as the 
preferred domain ID. 

The World Wide Name for the switch. 

Configured Insistent domain ID state as set in 
the conf ig . switch . insistDomainld 
command. 

Configured Domain RSCN state as set in the 
conf ig . switch . domainRSCN 
command. 

Configured Zoning RSCN state as set in the 
conf ig . switch . zoningRSCN 
command. 

The domain ID of the switch derived from the 
Fibre Channel Address. 
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Limited Fabric RSCN When enabled, fabric RSCNs are suppressed 

after an IPL. 



Output Example 

The output from the show, switch command displays as follows. 



Switch Information 
State: 
BB Credit : 
R_A_TOV : 
E_D_TOV : 

Preferred Domain Id: 
Switch Priority: 
Speed: 

Rerouting Delay: 
Operating Mode: 
Interop Mode : 
Active Domain Id: 
World Wide Name : 
Insistent Domain Id: 
Domain RSCN: 
Zoning RSCN: 
FC Address Domain Id 
Limited Fabric RSCN 



Online 
2 

20 

4 

1 

Default 

2 Gb/sec 

Enabled 

Open Systems 

Open Fabric 1 . 0 

1 

10 : 00 : 08 : 00 : 88 : 00 : 21 : 07 

Enabled 

Enabled 

Disabled 

67 (hexadecimal) 

Disabled 
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show.system 



Syntax 

Purpose 

Parameters 



system 



This command displays a set of system attributes. 



This command has no parameters. 



Command Example 



Output 



Root> show system 



The system attributes are displayed as a table that includes the following 
properties: 

Name 



Description 

Contact 

Location 

Date/Time 

Serial Number 
Type Number 
Model Name 
Model Number 



The system name as set in the conf ig . system . name 
command. 

The system description as set in the 

conf ig . system . description command. 

The system contact as set in the 

conf ig . system . contact command. 

The system description as set in the 

conf ig . system . description command. 

The system date and time as set in the 
conf ig . system, date command. 

The serial number for the system. 

The type number for the system. 

The name for the system (for example, Edge Switch 2/24). 

The model number for the system. All products have the 
model number 001, except 1-Gb sheet metal units, which 
have the model number 002. 
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EC Level 

Firmware 
Version 

Beaconing 



The engineering change level installed. 
The current firmware version installed. 

The enabled state of unit beaconing (enabled or disabled) 
as set in the maint . system . beacon command. 



Output Example 

The output from the show . system command displays as follows. 

System Information 

Name: hp3 director 

Description: hp StorageWorks director 2/64 



Contact : 
Location : 
Date /Time : 
Serial Number : 
Type Number : 
Model Name: 
Model Number; 
EC Level : 



Joe 

Everywhere 

04/16/2001 10:34:01AM 

123456789 

1 

ED-6064 
director 2/64 
1 



Firmware Version : 01 . 0 3 . 00 34 
Beaconing: Disabled 
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show.thresholdAlerts. alert 

Syntax 

alert 

Purpose 

This command provides the name, type, and enabled state of each threshold alert. 
This command displays information about all threshold alerts, including both 
counter threshold alerts (CTAs) and throughput threshold alerts (TTAs). 

Parameters 

This command has no parameters. 
Command Example 

Root> show thresholdAlerts alert 

Output 

The threshold alert data displays as a table that includes the following properties: 

Name The name of the threshold alert, truncated to 45 

characters. 



The trigger statistic or threshold type of the alert 
(abbreviated to 17 characters). These include: 


Tx Util 


TTA - Transmit Utilization 


Rx Util 


TTA - Receive Utilization 


Tx/Rx Util 


TTA - Transmit or Receive 
Utilization 


Link Resets Sent 


CTA - Link Resets Sent 


Link Resets Received 


CTA - Link Resets Received 


OLS Sent 


CTA - OLS Sent 


OLS Received 


CTA - OLS Received 


Link Failures 


CTA - Link Failures 


Sync Losses 


CTA - Sync Losses 
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Signal Losses 


CTA - Signal Losses 


Protocol Errors 


CTA - Primitive Sequence 
Errors/Protocol Errors 


Invalid Tx Words 


CTA - Invalid Tx Words 


CRC Errors 


CTA - CRC Errors 


Discarded Frames 


CTA - Discarded Frames 


Frames Too Short 


CTA - Frames Too Short 


Delimiter Errors 


CTA - Delimiter Errors 


Address ID Errors 


CTA - Address ID Errors 


Cls2 BusiedFrms 


CTA - Class 2 Busied Frames 


Cls2 RejectedFrms 


CTA - Class 2 Rejected Frames 


Cls3 DiscardFrms 


CTA - Class 3 Discarded 
Frames 


Phys Lnk Err Set 


CTA - Physical Link Errors 
Summed Set 


Lnk Seq Cnt Set 


CTA - Link Sequence Counts 
Summed Set 


Logic Lnk En - Set 


CTA - Logical Link Errors 
Summed Set 


Liri> Detected 


CTA - Loop Initialization 
Primitives Detected (Edge 
Switch 2/12 and 2/24) 


LIPS Generated 


CTA - Loop Initialization 
Primitives Generated (Edge 
Switch 2/12 and 2/24 only) 



State The enabled state of the CTA, either enabl ed or 

disabled. 

Output Example 

The output from the show. thresholdAlerts . alert command displays 
as follows. 

Name Type State 

Throughput Threshold #1 Rx Util Enable 
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Threshold for CRC CRC Errors Disabled 

Safety #2 Logic Lnk Err Set Enabled 

Safety #1 Cls2 BusiedFrms Disabled 
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show.thresholdAlerts.log 

Syntax 

log [clear] 

Purpose 

This command shows the contents of the threshold alert log. This log shows all 
the threshold alerts that have been triggered, including both counter threshold 
alerts (CTAs) and throughput threshold alerts (TTAs). 

Parameters 

This command has one parameter. 

clear This optional parameter causes all reroute log entries to 

be cleared. 



Command Example 



Output 



Root> show thresholdAlerts log 



The threshold alert log data displays as a table that includes the following 



properties: 

Date/Time 
Name 
Port 
Type 



The date and time of the alert. 

The name of the threshold alert, truncated to 22 characters. 

The type of threshold alert (CTAs only). 

The trigger statistic or threshold type of the alert 
(abbreviated to 17 characters). These include: 

Tx Util TTA - Transmit Utilization 

Rx Util TTA - Receive Utilization 



Tx/Rx Util 



TTA - Transmit or Receive 
Utilization 



Link Resets Sent 



CTA - Link Resets Sent 
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Link Resets Received 


CTA 


- Link Resets Received 


OLS Sent 


CTA 


- OLS Sent 


OLS Received 


CTA 


- OLS Received 


Link Failures 


CTA 


- Link Failures 


Sync Losses 


CTA 


- Sync Losses 


Signal Losses 


CTA 


- Signal Losses 


Protocol Errors 


CTA - Primitive Sequence 
Errors/Protocol Errors 


Invalid Tx Words 


CTA 


- Invalid Tx Words 


CRC Errors 


CTA 


- CRC Errors 


Discarded Frames 


CTA 


- Discarded Frames 


Frames Too Short 


CTA 


- Frames Too Short 


Delimiter Errors 


CTA 


- Delimiter Errors 


Address ID Errors 


CTA 


- Address ID Errors 


Cls2 BusiedFrms 


CTA 


- Class 2 Busied Frames 


Cls2 RejectedFrms 


CTA 


- Class 2 Rejected Frames 


Cls3 DiscardFrms 


CTA - Class 3 Discarded 
Frames 


Phys Lnk Err Set 


CTA - Physical Link Errors 
Summed Set 


Lnk Seq Cnt Set 


CTA 
Set 


- Link Sequence Counts 


Logic Lnk En - Set 


CTA 


- Logical Link Error Set 


LIPS Detected 


CTA 


- Loop Initialization 



Primitives Detected (Edge 
Switch 2/12 and 2/24 only) 



LIPS Generated CTA - Loop Initialization 

Primitives Generated (Edge 
Switch 2/12 and 2/24 only) 

Value The increment or utilization value of the alert. 

Interval The time interval of the alert. 
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Output Example 

The output from the show . thresholdAlerts . log command displays as 
follows. 

Date/Time Name Port Type Value Int 



05/26/02 


10 


:58A 


CTA Alert #4 


2 


Cls3 DiscardFrms 


250 


10 


05/24/02 


12 


: 01A 


CTA Alert #4 


2 


Cls3 DiscardFrms 


250 


10 


05/22/02 


10 


: 58A 


My test CTA 


43 


CRC Errors 


35 


30 


05/20/02 


08 


: 01P 


TTA Test #3 


2 


Tx Dtil 


85 


120 


03/01/02 


02 


: 58A 


CTA Alert #1 


130 


CRC Errors 


100 


60 
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show.zoning 

Syntax 

zoning 

Purpose 

This command shows the zoning configuration saved on the fabric. 

Parameters 

This command has no parameters. 
Command Example 

Root> show zoning 

Output 

The zoning configuration data is displayed as a table that includes the following 
properties: 

Active ZoneSet The enabled status, name, and member zones 
of the zone set. 



Output Example 

The output from the show . zoning command displays as follows. 



Active Zone Set 
Default Zone Enabled: False 
ZoneSet: TheUltimateZoneSet 
Zone: TheUltimateZone 



ZoneMember 
ZoneMember 
ZoneMember 
ZoneMember 
ZoneMember 



Domain 10 
Domain 15 
Domain 2 , 
10 : 00 
10 : 00 



Port 6 
Port 2 
Port 63 
00 : 00 :C9 : 22 
00 : 00 :C9 :22 



Zone : 



Zone : 



TheNo t S oUl t ima t e Z one 
ZoneMember: 10 : 00 : 00 : 00 : C9 : 22 
ZoneMember: 10 : 00 : 00 : 00 : C9 : 22 
ZoneMember: 10 : 00 : 00 : 00 : C9 : 22 

TheNotUltimateAtAllZone 
ZoneMember: Domain 2, Port 63 



9B: 64 
9B:BD 



AB 
C6 
AB 
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Error Messages 



This appendix lists and explains error messages for the command line interface 
(CLI). Any error numbers that are not listed are reserved for future use. 

The message that is returned is a string that includes the error number and the text 
of the message. 



Table 6: CLI Error Messages 



Message 


Description 


Action 


Error 05: Busy 


The switch is busy or 
processing another 
request. 


After a few seconds, 
reissue the request. 


Error 08: Invalid Switch 
Name 


The value entered for the 
switch name is invalid. 


The name for a director 
or edge switch can 
contain 0-24 characters. 
Enter a name with 0-24 
characters. If spaces are 
used, enclose the name in 
quotation marks. 


Error 09: Invalid Switch 


The value entered for the 
switch description is 
invalid. 


The description for the 
director or edge switch 
can contain 0-255 
characters. Enter a 
description with 0-255 
characters. If spaces are 
used, enclose trie 
description in quotation 
marks. 


Error 10: Invalid Switch 
Location 


The value entered for the 
switch location is invalid. 


The location for the 
director or edge switch 
can contain 0-255 
characters. Enter a 
location with 0-255 
characters. If spaces are 
used, enclose the location 
in quotation marks. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 1 1 : Invalid Switch 
Contact 


The value entered for the 
switch contact is invalid. 


The contact for the 
director or edge switch 
can contain 0-255 
characters. Enter a 
contact with 0-255 
characters. If spaces are 
used, enclose trie contact 
in quotation marks. 


Error 13: Invalid Port 
Number 


The value entered for the 
port number is invalid. 


Enter a port number 
within the range 
supported by the director 
or edge switch. Valid 
values are: 

■ 0-11 for the Edge 
Switch 2/12 

■ 0-1 5 for the Edge 
Switch 2/16 

■ 0-23 for the Edge 
Switch 2/24 

■ 0-31 for the Edge 
Switch 2/32 

■ 0-63 for the Director 

2/64 

■ 0-1 27 and 132-143 
for the Director 
2/140 


Error 14: Invalid Port 
Name 


The value entered for the 
port name is invalid. 


The port name for the 
individual port can 
contain 0-24 characters. 
Enter a name with 0-24 
characters. If spaces are 
used, enclose the name in 
quotation marks. 


Error 15: Invalid BB 
Credit 


The value entered for the 
buffer-to-buffer credit is 
invalid. 


The buffer-to-buffer credit 
must be an integer in the 
range 1-60. Enter a 
value in the range 1-60 
characters. A 
buffer-to-buffer credit is 
not used for ports 
configured for extended 
distance. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 16: Invalid 
R_A_TOV 


The value entered for the 
resource allocation 
time-outvalue is invalid. 


The R A_TOV is entered 
in tenths of a second and 
must be an integer in the 
range 10-1200(1 
second to 120 seconds). 
The R_A_TOV value must 
be larger than the 
E_D_TOV value. Check to 
be sure that all these 
conditions are met and 
re-submit. 


Error 17: Invalid 
E_D_TOV 


The value entered for the 
error detect time-out 
value is invalid. 


The E D_TOV is entered 
in tenths of a second and 
must be an integer in the 
range 2-600 (0.2 second 
to 60 seconds). The 
E_D TOV value must be 
smaller than the 
R A TOV value. Check 
to be sure that all these 
conditions are met and 
re-submit. 


Error 18: Invalid TOV 


The E_D_TOV and 

R A TOV values are not 

compatible. 


Enter a valid 

E_D TOV/R_A TOV 

comToination. The 

E_D TOV must be 

smaller than the 

R_A_TOV. 


Error 20: Invalid 
Preferred Domain ID 


The value entered for the 
preferred domain ID for 
the director or edge 
switch is invalid. 


The preferred domain ID 
must be an integer in the 
range 1-31 . Enter an 
appropriate value and 
resubmit. 


Error 21 : Invalid Switch 
Priority 


The value entered for the 
switch priority is invalid. 


The switch priority 
entered for the director or 
switch must be 

principal, default, 
or neverprincipal. 
(Refer to the description 
of the command 
"config. switch, priority" 
on page 109.) Enter 
principal, default, 
or neverprincipal. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 29: Invalid 
Gateway Address 


The value entered for the 
gateway address is 
invalid. 


The new gateway 
address for the Ethernet 
interface must be entered 
in dotted decimal format 
(for example, 0.0.0.0). 
Enter the gateway 
address for the Ethernet 
interface in the dotted 
decimal format. 


Error 30: Invalid IP 
Address 


The value entered for the 
IP address of the director 
or edge switch is invalid. 


The IP address for the 
Ethernet interface must be 
entered in dotted decimal 
format (for example, 
10.0.0.0). Enter the IP 
address for the Ethernet 
interface in dotted 
decimal format. 


Error 31 : Invalid Subnet 
Mask 


The value entered for the 
new subnet mask for the 
Ethernet interface is 
invalid. 


The subnet mask must be 
entered in dotted decimal 
format [for example, 
255.0.0.0). Enter the 
subnet mask for the 
Ethernet interface in 
dotted decimal format. 


Error 32: Invalid SNMP 
Community Name 


The value entered for the 
SNMP community name 
is invalid. 


The SNMP community 
name is the name of the 
community specified in 
the command 
"config.snmp.addCommu 
nity" on page 94. The 
community name must 
not exceed 32 
characters. Valid 
characters include all 
those in the ISO Latin- 1 
character set. Duplicate 
community names are 
allowed, but the 
corresponding 
writeAuthorization values 
must match. Enter an 
SNMP community name 
that meets all of the 
requirements. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 33: Invalid SNMP 
Trap Address 


The value entered for the 
SNMP trap address is 
invalid. 


The new SNMP trap 
address for the SNMP 
interface must be entered 
in dotted decimal format 
(for example, 10.0.0.0). 
Enter an SNMP trap 
address that meets the 
requirements. 


Error 34: Duplicate 
Community Names 
Require Identical Write 
Authorization 


The two or more entered 
community names are 
identical, but their 
corresponding write 
authorizations are not 
identical. 


Enter different values for 
the community names, or 
enter identical write 
authorizations for the 
duplicate community 
names. 


Error 37: Invalid Month 


The value of the month 
entered for the new 
system date is invalid. 


The format of the date 
parameter must be 
mm:dd:yyyy or 
mm/dd/yyyy. The month 
must contain an integer in 
the range 01-1 2. Enter a 
date, including a month 
in the range 01-1 2. 


Error 38: Invalid Day 


The value of the day 
entered for the new 
system date is invalid. 


The format of the date 
parameter must be 
mm:dd:yyyy or 
mm/dd/yyyy. The day 
must contain an integer in 
the range 01-31 . Enter a 
date, includinga day in 
the range 01^31 . 


Error 39: Invalid Year 


The value of the year 
entered for the new 
system date is invalid. 


The format of the date 
parameter must be 
mm:dd:yyyy or 
mm/dd/yyyy. The year 
must contain an integer 
greater than 1980. Enter 
a date, including a year 
greater than 1980. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 40: Invalid Hour 


The value of the hour 
entered for the new 
system time is invalid. 


The format of the time 
parameter must be 
hh:mm:ss. The hour must 
contain an integer in the 
range 00—23. Enter a 
time, including an hour in 
the range 00-23. 


Error 41 : Invalid Minute 


The value of the minute 
entered for the new 
system time is invalid. 


The format of the time 
parameter must be 
hh:mm:ss. The minute 
must contain an integer in 
the range 00—59. Enter a 
time, including minutes in 
the range 00-59. 


Error 42: Invalid Second 


The value of the second 
entered for the new 
system time is invalid. 


The format of the time 
parameter must be 
hh:mm:ss. The second 
must contain an integer in 
the range 00—59. Enter □ 
time, including seconds in 
the range 00-59. 


Error 44: Max SNMP 
Communities Defined 


A new SNMP community 
cannot be defined before 
removing an existing 
community from the list. 


A total of six communities 
may be defined for 
SNMP. Remove at least 
one of the current 
communities, and then 
define the new 
community. 


Error 45: Not Allowed 
While Switch Online 


The entered command 
requires that the director 
or edge switch be set 
offline. 


Set the director or switch 
offline before reentering 
the command. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 55: Invalid Zone 
Name 


The value entered for the 
zone name is invalid. 


The zone name must 
contain 1-64 characters. 
Valid characters are 
ABCDEFGHIJKLMNOPQ 
RSTUVWXYZabcdefghijkl 
mnopqrstuvwxyzOl 2345 
6789$- A _ (spaces are 
not permitted, and the 
first character must be 
alphabetical). Enter a 
zone name in the range 
of 1-64 characters, using 
the valid characters. 


Error 57: Duplicate Zone 


Two or more zone names 
in the zone set are 
identical . 


All zone names within a 
zone set must be unique. 
Enter a zone name that 
does not duplicate the 
name of another zone 
within the zone set. 


Error 59: Zone Name in 
Use 


Two or more zone names 
in the zone set are 
identical. 


All zone names within a 
zone set must be unique. 
Enter a zone name that 
does not duplicate the 
name of another zone 
within the zone set. 


Error 60: Invalid Number 
of Zone Members 


The entered command 
tried to add more zone 
members than the zone 
can hold. 


Delete one or more zone 
members in the zone, 
and then resubmit the 
command to add the new 
zone member. 


Error 61 : Invalid Zone 
Member Type 


The specified zone 
member is neither a 
World Wide Name 
(WWN) nor a 
domain-port pair. 


The zone member type 
must be either a World 
Wide Name (WWN) or 
a 

domain-port pair. Refer 
to the command 
"config. zoning. addWwn 
Mem" on page 1 35 or 
"config. zoning. addPortM 
em" on page 1 36 for 
specific requirements. 
Enter either a WWN or 
domain-port pair that 
meets the requirements. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 62: Invalid Zone Set 
Name 


The value entered for the 
zone set name is invalid. 


The zone set name must 
contain 1-64 characters. 
Valid characters are 
ABCDEFGHIJKLMNOPQ 
RSTUVWXYZabcdefghijkl 
mnopqrstuvwxyzOl 2345 
6789$- A _ (spaces are 
not permitted, and the 
first character must be 
alphabetical). Enter a 
zone set name in the 
range of 1-64 
characters, using the 
valid characters. 


Error 69: Duplicate Port 
Name 


Two or more port names 
are identical. 


Port names must be 
unique. The name must 
contain 1-24 characters. 
Enter a port name in the 
range of 1-24 
characters. 


Error 70: Invalid Device 
Type 


The specified FRU does 
not exist on this product. 


Refer to the product 
service manual for 
product-specific FRU 
information. 


Error 71 : FRU Not 
Installed 


The specified FRU is not 
installed. 


Refer to the product 
service manual for 
product-specific FRU 
information and 
procedures. 


Error 72: No Backup FRU 


The FRU cannot be 
swapped because a 
backup FRU is not 
installed. 


Refer to the product 
service manual for 
product-specific FRU 
information and 
procedures. Insert a 
backup FRU, and reenter 
the command. 


Error 73: Port Not 
Installed 


The specified port is not 
installed on the product. 


Refer to the product 
service manual for 
information about 
installing a port optic. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 74: Invalid Number 
of Zones 


The specified zone set 
contains less than one 
zone or more than the 
maximum number of 
zones allowed for this 
product. 


The zone set must contain 
at least one zone. Add or 
remove zones to stay 
within the required 
number of zones for this 
product. 


Error 75: Invalid Zone Set 
Size 


The specified zone set 
exceeds the NVRAM 
limitations of the director 
or edge switch. 


Reduce the size of the 
zone set to meet the 
NVRAM limitations of the 
product. Reduce the 
number of zones in the 
zone set, reduce the 
number of members in a 
zone, or reduce the zone 
name lengths. 


Error 76: Invalid Number 
of Unique Zone Members 


The specified zone 
contains more than the 
maximum number of 
zone members allowed 
per zone set for this 
product. 


Reduce the number of 
members in the zone 
before reentering the 
command. 


Error 77: Not Allowed 
While Port Is Failed 


The specified port is in a 
failed or inactive state or 
requires service. 


Refer to the product 
service manual for the 
appropriate action. 


Error 78: System Error 
Light On 


This product cannot 
beacon because the 
system error light is on. 


Refer to the product 
service manual for the 
appropriate procedure. 
Clear the system error 
light before enabling 
beaconing. 


Error 79: FRU Failed 


The specified FRU has 
failed. 


Refer to the product 
service manual for the 
appropriate procedure. 


Error 81 : Default Zone 
Enabled 


The request cannot be 
completed because the 
default zone is enabled. 


Disable the default zone 
before reentering the 
command. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 82: Invalid Interop 
Mode 


The value entered for the 
interoperability mode is 
not valid. 


The interoperability mode 
for the director or edge 
switch must be 
Homoqenous Fabric or 
Open Fabric 1.0. Enter 
mcdata (Homogenous 
Fabric) or open (Open 
Fabric 1 .0) to set the 
interoperability mode. 


Error 83: Not Allowed in 
Open Fabric Mode 


This request cannot be 
completed while this 
switch is operating in 
Open Fabric 1 .0 mode. 


Configure the 
interoperability mode to 
Open Fabric 1.0 mode. 


Error 88: Invalid Feature 
Key Length 


The value of the specified 
feature key is longer than 
the maximum length 
allowed. 


Refer to the command 
"config. features. installKe 
y" on page 45for 
requirements, and reenter 
the feature key. If 
problems persist, contact 
your sales representative. 


Error 89: Not Allowed in 
S/390 Mode Without the 
SANtegrity™ Feature - 


This procedure is not 
allowed in S/390 mode 
(FICON management 
style in HAFM). 


The entered command is 
only supported when the 
product is in Open 
Systems mode (Open 
Systems management 
style in HAFM). The 
product cannot be taken 
out of S/390 mode 
(FICON management 
style) through the CLI. Use 
the HAFM application to 
change the product 
management style, and 
then reenter the 
command. 


Error 90: Invalid Port 
Type 


The configured port type 
is invalid. 


The port may be 
configured as an E Port, 
G_Port, or F Port. 
Reconfigure the port, and 
then resubmit the 
command. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 91: E_PortType 
Configured 


Ports cannot be 
configured as E Ports in 
S/390 mode (FICON 
management style in 
HAFM). 


Reconfigure the port as 
either an F Port or a 
O_rort, and then 
resubmit the command. 


Error 92: Not Allowed 

\ a /I ■ 1 rt ■ i i i I I I I 

While Port Is Unblocked 


The port must be blocked 
to complete this request. 


Block the port, and then 
i *■ ii i 
resubmit the command. 


Error 93: Not Allowed 
While FICON MS Is 
Installed 


This request cannot be 
completed because 
FICON Manaqement 
berver is installed. 


This action is not 
supported. No action 
necessary. 


Error 94: Invalid Feature 
Combination 


The requested features 
cannot be installed at the 
same time on one 
director or edge switch. 


Contact your sales 
representative. 


Error 99: Preferred 
Domain ID Cannot Be 
Zero 


This switch cannot be 
confiqured to have a 

£ J J -in 

preferred domain ID 
equal to zero (0). 


Enter an integer in the 

ranqe 1-31 for the 

r j j if. 
preferred domain ID. 


Error 101: Command 
Not bupported on 1 his 
Product 


This product does not 
support the specified 
command. 


Information only 
message: this operation is 
not supported. 


Error 102: Switch Not 
Operational 


The request cannot be 

completed because the 

■i i ± ■ * i 
switch is not operational. 


Refer to the product 
service manual, and 
consult your service 
representative. 


Error 103: Port 
Diagnostic In Progress 


The request cannot be 
completed because a port 
diagnostic is running. 


Wait for the diagnostic to 
complete. 


Error 104: System 
Diagnostic In Progress 


The request cannot be 
completed because a 
system diagnostic is 
running. 


Wait for the diagnostic to 
complete. 


Error 105: Max 
Threshold Definitions 
Reached 


The maximum number of 
total threshold alerts has 
already been reached. 


Remove a threshold alert 
before adding the new 
threshold alert. A total of 
16 counter and 
throughput threshold 
alerts is allowed. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 106: Invalid 
Threshold Scope 


The scope of a threshold 
alert is not set to a valid 
state before the user 
activates an alert. 


Set the scope of the 
threshold alert, then try to 
activate the alert. 


Error 107: Invalid 
Threshold State 


The scope of a threshold 

i ± , i , i r 
alert must be set before 

the user activates an 

alert. 


Set the scope of the 
threshold alert, then try to 
activate the alert. 


r~ n /~\ o i 1* 1 i i a 

Error 108: Invalid TTA 
Type 


1 he type ot the 
throughput threshold alert 
has not been set. 


f i il i t 1 1 TT A 

Set the type ot the TTA, 
then try to activate the 
alert. 


Error 109: Invalid CTA 
Type 


The type of the counter 

threshold alert has not 
i , 
been set. 


Set the type of the CTA, 

then try to activate the 

i . 
alert. 


Error 1 10: Invalid Percent 
Utilization 


The type of the 
throughput threshold alert 
has not been set. 


Set the type of the TTA, 
then try to activate the 
alert. 


Error 111: Invalid 
Threshold Type 


The type of the threshold 
alert is not valid. 


Configure the type of the 
throughput threshold alert 
to one of the types found 
in the enumerated table 
for TTAs. 


Error 1 12: No Threshold 
Definition Given 


The threshold value for 
the alert was not 
configured before the 
user attempted to activate 
the alert. 


Set the threshold value, 
then try to activate the 
alert. 


Error 1 15: Invalid Switch 
Speed 


The request cannot be 
completed because the 
switch is not capable of 
operating at the 
configured speed. 


Refer to the product 
service manual to 
determine the speed 
capabilities of the 
product. 


Error 1 16: Switch Not 
Capable of 2 Gbps 


The request cannot be 
completed because the 
switch is not capable of 
operating at 2.125 
gigabits per second 
(Gljps). 


Refer to the product 
service manual to 
determine the speed 
capabilities of the 
product. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 1 1 7: Ports Cannot 
be Set at Higher Data 
Rate than Switch Speed 


The request cannot be 
completed because the 
requested port speed is 
faster than the configured 
switch speed. 


The switch speed should 
first be configured to 
accommodate changes in 
the configured port 
speed. The ports cannot 
operate at a faster rate 
than the switch itself. 
Update the switch speed 
and resubmit the request. 
For more information 
about setting speeds, see 
"confiq. switch. speed" on 
page 114 and 
"config jport.speed" on 
page 60. 


Error 1 1 8: Invalid Port 
Speed 


This request cannot be 
complefed because the 
requested port speed is 
not recognized for this 
product. 


Port speeds may be set to 
1 Gbps or 2 Gbps. 
Update the port speed 
and resubmit the request. 


Error 1 19: Switch Speed 
Not 2 Gb/sec 


This request cannot be 
completed because the 
switch speed has no been 
set to 2 Gbps. 


The switch speed must be 
set to 2 Gbps in order to 
accommodate a port 
speed of 2 Gbps. Update 
the switch speed and 
resubmit the request. 


Error 1 34: Invalid 
Membership List 


Generic message to 
indicate a problem in 
either the Switch Binding 
or Fabric Binding 
Membership List. 


Be sure that the 
membership list submitted 
does not isolate a switch 
already in the fabric. If 
this is not the case, the 
user needs to be aware of 
all fabric security rules 
and make sure tnat the 
list submitted adheres 
appropriately. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 1 35: Invalid 
Number of Fabric 
Membership List Entries 


The number of fabric 
members submitted 
exceeds the maximum 
allowable entries of 31 . 


The number of entries in 
the Fabric Membership 
List is limited to the total 
number of domain IDs 
available to the fabric. 
Make sure that the list 
(including the managed 
switch) contains no more 
than 31 entries. 


Error 1 36: Invalid 
Number of Switch 
Binding Membership List 
Entries 


The number of switch 
members submitted 
exceeds the maximum 
allowable entries of 256. 


The number of entries in 
the Switch Binding 
Membership List is limited 
to 256. Make sure that 
the list (including the 
managed switch) 
contains no more than 
256 entries. 


Error 137: Invalid Fabric 
Binding State 


The fabric binding state 
submitted is not 
recognized by the CLI. 


The fabric binding state 
must be set either to 
inactive or restrict. For 
more information, see 
"config. security. fabricBin 
ding Commands" on 
page 64. 


Error 1 38: Invalid Switch 
Binding State 


The switch binding state 
submitted is not 
recognized by the CLI. 


The switch binding state 
must be set to one of the 
following: disable, 
erestrict, 
f restrict, or 
allrestrict. For 
more information, see 
"Port Number: 4 WWN 
Binding: Active Bound 
WWN: 

AA:99:23:23:08:14:88: 
CI" on page 80. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 139: Insistent 
Domain ID's Must Be 
Enabled When Fabric 
Binding Active 


The user attempted to 
disable insistent domain 
IDs while fabric binding 
was active. 


Insistent domain IDs must 
remain enabled while 
fabric binding is active. If 
fabric binding is set to 
inactive, the insistent 
domain ID state may be 
chanqed. It should be 
noted, however, that this 
can be disruptive to the 
fabric. 


Error 140: Invalid 
Insistent Domain ID State 


The request cannot be 
completed because an 
invalid insistent domain 
ID state has been 
submitted. 


The insistent domain ID 
state must be set to either 
enable or disable. 
For more information, see 
"conf ig. switch. insistDoma 
inld" on page 104. 


Error 141 : Invalid 
Enterprise Fabric Mode 


The request cannot be 
completed because an 
invalid Enterprise Fabric 
Enterprise Fabric mode 
has been submitted. 


The Enterprise Fabric 
mode must be set to 
either activate or 
deactivate. For more 
information, see 
"config.features.enterpris 
eFabMode" on page 43. 


Error 142: Invalid 
Domain RSCN State 


The request cannot be 
completed because an 
invalid domain RSCN 
state has been submitted. 


The domain RSCN state 
must be set to either 
enable or disable. 
For more information, see 
"conf ig. switch. domainRS 
CN"on page 103. 


Error 143: Domain 
RSCNs Must Be Enabled 
When Enterprise Fabric 
Mode Active 


The user attempted to 
disable domain RSCNs 
while Enterprise Fabric 
mode was active. 


Domain RSCNs must 
remain enabled while the 
Enterprise Fabric mode is 
active. If Enterprise Fabric 
mode is set to inactive, 
the domain RSCN state 
may be changed. It 
should be noted, 
however, that this can be 
disruptive to the fabric. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 144: The 
SANtegrity Feature Has 
Not Been Installed 


The user attempted to 
activate a change to the 
fabric security 
configuration without first 
installing the SANtegrity 
feature key. 


If this key has not been 
installed, contact your 
sales representative. 


Error 146: Fabric Binding 
May Not Be Deactivated 
While Enterprise Fabric 
Mode Active 


The user attempted to 
deactivate fabric binding 
while Enterprise Fabric 
mode was active. 


Fabric binding must be 
active while operating in 
Enterprise Fabric mode. 
The fabric binding state 
may be changed if 
Enterprise Fabric mode is 
deactivated. It should be 
noted, however, that this 
can be disruptive to the 
fabric. 


Error 148: Not Allowed 
While Switch Offline 


The switch must be online 
to complete this request. 


Change the state of the 
switch to ONLINE and 
re-submit the request. 


Error 149: Not Allowed 
While Enterprise Fabric 
Mode Enabled and 
Switch Active 


The request cannot be 
completed while the 
switch is online and 
Enterprise Fabric mode is 
Active. 


This operation will be 
valid if the switch state is 
set to offline and 
Enterprise Fabric mode to 
inactive. It should be 
noted, however, that this 
can be disruptive to the 
fabric. 


Error 151: Invalid Open 
Systems Management 
Server State 


The request cannot be 
completed because the 
OSMS state submitted is 
invalid. 


The OSMS state may be 
set to either enable or 
disable. For more 
information, see 
"config. features. enterpris 
eFabMode" on page 43. 


Error 152: Invalid FICON 
Management Server State 


The request cannot be 
completed because the 
FICON MS state 
submitted is invalid. 


The FICON MS state may 
be set to either enable or 
disable. For more 
information, see 
"config .features.f iconms" 
on page 44. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 153: Feature Key 
Not Installed 


The request cannot be 
completed because the 
required feature key has 
not been installed to the 
firmware. 


Contact your sales 
representative. 


Error 1 54: Invalid 
Membership List WWN 


The request cannot be 
completed because the 
WWN does not exist in 
the switch binding 
membership list. 


Make sure that the WWN 
deleted matches the 
WWN in the Switch 
Binding Membership List. 
Make appropriate 
changes ana re-submit 
the request. 


Error 155: Cannot 
Remove Active Member 
From List 


This member cannot be 
removed from the fabric 
security list because it is 
currently logged in. 


Fabric security rules 
prohibit any device or 
switch from being 
isolated from the fabric 
via a membership list 
change. If it is truly the 
intention of the user to 
remove the device in 
question from the 
membership list, then 
there are several 
approaches to take. This 
request may be 
completed most 
non-disruptively by 
blocking the port (or 
physically removing the 
device from the managed 
switch) to which this 
device is attached and 
resubmitting the request. 


Error 156: Cannot 
Complete while Switch is 
Online and Fabric 
Binding is Active 


The switch must be offline 
and fabric binding must 
be inactive before this 
feature can be disabled. 


Deactivating this feature 
can be disruptive to 
fabric operations. Take 
the switch offline and 
deactivate fabric binding 
before disabling this 
feature. 
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Message 


Description 


Action 


Error 157: Access 
Control List is Disabled 


The switch must be offline 
and Fabric Binding must 
be inactive before this 
feature can be disabled. 


Deactivating this feature 
can be disruptive to 
Fabric operations. Take 
the switch offline and 
deactivate fabric bindinq 

L £ J- LI- rL- 

betore disabling this 
feature. 


Error 158: Invalid IP 

A f~~ l 1 i ' i n 

Access Control List Pair 


The pair of IP addresses 
• i • j j ■ i 
are invalid and cannot be 

added to the list. 


Make sure the IP 

j j i- j j 
addresses are valid and 

the first IP is lower than 

the second. 


Error 159: Invalid IP 
Access Control List Pairs 
Count Value 


The list being activated 
has an invalid number of 
IP pairs. 


Make sure there is at least 
one IP address in the 
Access Control List. 


Error 160: Management 

/—i • , m k i i i 1 1 1 i 

Client IP Not Included In 
IP Access Control List 


The manaqement 

• i £ in JJ • i 

interface IP address is not 
in the list. 


The manaqement IP must 

L • iL I* i iL i 

be in the list or the current 
connection would be lost. 


Error 161 : SANteqrity 

A iL i' i' £ i 

Authentication feature 
key must be uninstalled 


The operation cannot be 
completed with the 
SANtegrity 
Authentication key 
installed. 


Remove the SANteqrity 
Authentication teature 
key. 


Error 162: List is tull 


Tl 

1 here is no more room 
for new entries in the list. 


Remove a ditterent entry 
and try again. 


Error 163: FICON MS 

feature key must be 

i ii j 
installed 


The command is not 
available without the 
FICON MS teature key. 


Install the FICON MS 
feature key. 


Error 164: FICON CUP 
Zoninq feature key must 
be uninstalled 


The operation cannot be 
completed with the 
ni_UN LUr z.oning key 
installed. 


Remove the FICON CUP 
Zoning feature key. 


Error 165: CUP Zoning 
feature key must be 
installed 


The command is not 
available without the 
FICON CUP Zoning 
feature key. 


Install the FICON CUP 
zoning feature key. 


Error 166: CUP Zoning 
feature must be enabled 


The command cannot be 
completed with the CUP 
Zoning feature enabled. 


Enable FICON CUP 
Zoning. 
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Message 


Description 


Action 


Error 167: Diagnostics 
can not be run on 
inactive port 


~rl i * • i| * 

Ihe port is in the inactive 
state and diagnostics 
can't be run. 


The port state must 
change out of the inactive 
state. 


Error 168: Duplicate 
member in the list 


~rl i • • i\ i* 

Ihe port is in the inactive 
state and diagnostics 
can't be run. 


The port state must 
change out of the inactive 
state. 


Error 169: CNT support 
± ii i 
in is an incorrect enabled 

state 


CNT support is in the 
wrong state. 


The enabled state for 

/— k |T" ill 

CNI support must be 
changed. 


r~ i ~i f~\ r~\ 1* i in 

Error 170: Duplicate IP 
Address pair in the 
Access Control List 


I- l in 1 1 

uplicate Ir address pairs 
are not allowed in the 
Access Control List. 


Tl • 1 ■ 

I his command is 
redundant, the member 
already exists in the list. 


Error 1 71 : Invalid 
username 


The username is invalid. 


Enter a unique username 
using only the allowed 
characters and proper 
length. 


Error 172: Invalid list size 


The number of entries in 
the list is invalid. 


Make sure the list has at 
least one entry. 


Error 173: Invalid value 


The value being entered 
is invalid. 


Enter a valid value. 


Error 174: Invalid list 
data 


The list data is invalid. 


Correct the list to make it 
a valid list. 


Error 175: Invalid list 

• _l /iL L IJ i 

index (the user should not 
see this error) 


The index in the list is 
incorrect. 


Correct the index. 


Error 1 76: Entry not 

£ J • iL I* i 

tound in the list 


The desired entry in the 
i* i j i • I 
list does not exist. 


Make sure the desired 

1 * iL I* 1 J *L • 

entry is in the list and it is 
being typed correctly. 


Error 1 77: Cannot 
remove the last user with 
Administrator rights 


At least one 

Administrator user must 
exist for each 
management interface. 


Add a new Administrator 
and then try again. 


Error 1 78: Invalid 
password 


The entered password is 
invalid. 


Enter a password using 
valid characters and a 
proper length. 


Error 179: Insistent 
Domain IDs must be 
enabled 


To complete this 
command, Insistent 
Domain IDs must be 
enabled. 


Enabled Insistent Domain 
IDs. 
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Message 


Description 


Action 


Error 180: Too many 
authentication 
management users 


Only lb management 
users can be added to the 
user database. 


Remove other 
management users in 
order to make room for a 
new one. 


Error 181 : Preferred path 
must be disabled 


The Preferred Path 
feature must be disabled. 


Disable the Preferred 
Path feature. 


Error 182: Source port 
must be different than the 
exit port 


The source and exit ports 
cannot be the same. 


Configure a preferred 
path with different source 
and exit ports. 


Error 201 : Change 
Authorization Request 
Failed 


The switch did not accept 
the request to make a 
change to NVRAM. 


Check that all the 
parameters are correct, 
and reenter the 
command. If problems 
persist, contact your 
service representative. 


Error 202: Invalid 
Change Authorization ID 


The switch will not accept 
a change request from 
this particular client. 


Check that all the 
parameters are correct, 
and reenter the 
command. If problems 
persist, contact your 
service representative. 


Error 203: Another Client 
Has Change 
Authorization 


Another user is currently 
making changes to this 
switch. 


Check that all the 
parameters are correct, 
and reenter the 
command. 


Error 207: Change 
Request Failed 


The switch did not accept 
the request. 


Check that all the 
parameters are correct, 
and reenter the 
command. If problems 
persist, contact your 
service representative. 


Error 208: Change 
Request Timed Out 


The authorization time 
allowed to make NVRAM 
changes has expired. 


Check that all the 
parameters are correct, 
and reenter the 
command. If problems 
persist, contact your 
service representative. 
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Message 


Description 


Action 


Error 209: Change 
Request Aborted 


The switch did not accept 
the request. 


Check that all the 
parameters are correct, 
and reenter the 
command. If problems 
persist, contact your 
service representative. 


Error 210: Busy 
Processing Another 
Request 


A different switch in the 
fabric was busy 
processing another 
request and could not 
complete the command. 


Check that all the 
parameters are correct, 
and reenter the 
command. If problems 
persist, contact your 
service representative. 


Error 211: Duplicate 
Zone 


The entered command 
tried to add a zone name 
that already exists in the 
local zone set. 


All zone names must be 
unique. Delete or rename 
the zone with the 
duplicate name before 
reentering the command; 
or change the name of 
the new zone, and 
reenter the command. 


Error 212: Duplicate 
Zone Member 


The entered command 
tried to add a member 
that already exists in the 
zone. 


No action required 


Error 213: Number of 
Zones Is Zero 


The 

config. zoning. activateZo 
neSet command tried to 
activate a zone set 
contained in the work 
area to the fabric; 
however, the zone set is 
empty. 


A zone set must have at 
least one zone to be a 
valid zone set. Add at 
least one zone to the 
zone set, and then 
reenter the 

config. zoning. activateZo 
neSet command to 
activate the zone set in 
the work area to the 
fabric. 
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Message 


Description 


Action 


Error 214: A Zone 
Contains Zero Members 


The 

config. zoning. activateZo 
neSet command tried to 
activate the zone set 
contained in the work 
area to the fabric; 
however, the zone set 
contains at least one zone 
that is empty. 


Each zone in the zone set 
must contain at least one 
zone member. Add zone 
members so that each 
zone has at least one 
zone member; then 
reenter the 

config. zoning. activateZo 
neSet command to 
activate the zone set in 
the work area to the 
fabric. 


Error 215: Zone Set Size 
Exceeded 


The size of the local 
work-area zone set has 
outgrown the size 
supported by the CLI. 


Reduce the size of the 
zone set to meet CLI 
requirements by doing 
one or more of the 
following: 

■ reduce the number of 
zones in the zone set 

■ reduce the number of 
members in a zone 

■ reduce the length of 
zone names 


Error 218: Invalid Port 
Number 


The value specified for 
the port number is 
invalid. 


Enter a port number 
within the range 
supported by the director 
or edge switch. Valid 
values are: 

■ 0-11 for the Edge 
Switch 2/12 

■ 0-1 5 for the Edge 
Switch 2/16 

■ U-zo tor the cage 
Switch 2/24 

■ 0-31 for the Edge 
Switch 2/32 

■ 0-63 for the Director 

2/64 

■ 0-1 27 and 132-143 
for the Director 
2/140 
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Message 


Description 


Action 


Error 219: Invalid Port 
Type 


The value specified for 
the port type is invalid. 


A port may be configured 
as an E_Port, a G_Port, 
or an F_Port. Make sure 
the port is configured 
appropriately and 
resubmit the command. 
The Fx_port and Gx_port 
types are also supported 
on the Edge Switch 2/24. 


Error 222: Invalid SNMP 
Community Index 


The value specified for 
the SNMP community 
index is invalid. 


The SNMP community 
index must be an integer 
in the range 1-6. Enter 
an integer in the range 


Error 223: Unknown 
Error 


The switch did not accept 
the request. 


Contact your service 
representative. 


Error 224: Invalid 
Argument 


The values entered for 
one or more parameters 
of the command are 
invalid. For example, a 
letter may have been 
entered where an integer 
is required. 


Refer to "CLI Commands" 
on page 39 for 
information about the 
command parameters. 
Check that all parameters 
are typed correctly, and 
then resubmit the 
command. 


Error 225: Argument 
Does Not Contain All 
USASCII Characters 


The CLI received one or 
more non-USASCII 
characters. 


Refer to "CLI Commands" 
on page 39 for 
information about the 
command parameters. 
Check that all parameters 
are typed correctly, and 
then resubmit the 
command. 


Error 226: Argument Is 
Too Long 


One or more parameters 
of the specified command 
are invalid. 


Refer to "CLI Commands" 
on page 39 for 
information about the 
command parameters. 
Check that all parameters 
are typed correctly, and 
resubmit the command. 
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Message 


Description 


Action 


Error 227: Invalid SNMP 
Community Name 


The value specified for 
the SNMP community 
name is invalid. 


The community name 
must not exceed 32 
characters in length. 
Duplicate community 
names are allowed if the 
corresponding write 
authorizations match. 
Specify a valid SNMP 
community name, and 
resubmit the command. 


Error 228: Invalid Write 
Authorization Argument 


The writeAuthorization 
parameter does not 
contain a valid value. 


Parameters must be typed 
exactly to specification to 
be recognized correctly 
by the CLI. For more 
information, see 
"config.snmp.addCommu 
nity" on page 94. 


Error 229: Invalid UDP 
Port Number 


The udpPortNum 
parameter does not 
contain a valid value. 


Parameters must be typed 
exactly to specification to 
be recognized correctly 
by the CLI. For more 
information, see 
"config. switch. insistDoma 
inld" on page 1 04. 


Error 230: Invalid WWN 


The WWN parameter 
does not contain a valid 
value. 


For the appropriate 
parameters, see the 
section of the manual that 
corresponds to the 
attempted command. 
Parameters must be typed 
exactly to specification to 
be recognized correctly 
by the CLI. 


Error 231: Invalid Port 
Number 


The value specified for 
the portNumber 
parameter is invalid. 


Refer to "CLI Commands" 
on page 39 for 
information about the 
commands with the 
portNumber parameter. 
Specify a valid port 
number value, and 
resubmit the command. 
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Message 


Description 


Action 


Error 232: Invalid 
Domain ID 


The value specified for 
the domainid parameter 
is invalid. For example, 
the domainid parameter 
of the 

con fig . switch . pr 
ef Domainid 
command requires an 
integer in the range 
1-31. 


Refer to "CLI Commands" 
on page 39 for 
information about the 
commands with the 
domainid parameter. 
Specify a valid domain ID 
value, and resubmit the 
command. 


Error 233: Invalid 
Member 


The value specified for 
the zoneName parameter 
(the name of the zone 
member) is invalid. 


Refer to "CLI Commands" 
on page 39 for 
information about the 
commands with the 
zoneName parameter. 
Specify a valid name for 
the zone member, and 
resubmit the command. 


Error 234: Invalid 
Command 


The CLI cannot associate 
an action with the 
submitted command. The 
command may be 
misspelled, required 
parameters may be 
missing, or the request 

mn\/ r\r\\ nnn imn p \r\ 

the branch of the CLI tree 
from which it was 
submitted. 


Refer to "CLI Commands" 
on page 39 for the 
correct command syntax 
and spelling. Ensure that 
the command is spelled 
correctly and that all 
reauired parameters are 

mr i irl^rJ Wltn tnP 

II ILIUUCU W 1 1 1 I 1 1 IC 

command. 

Refer to "Navigation of 
the CLI Command Tree" 
on page 26. Ensure that 
the command has been 
entered at the right place 
in the CLI command tree, 
and then resubmit the 
command. 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 235: Unrecoqnized 
Command 


The CLI does not 
recognize the submitted 
command and cannot 
perform the help ( ? ) 
command as requested. 


Refer to "Using the 
Command Line Interface 
Help" on page 35for 
information about the 
help command. 

Refer to "CLI Commands" 
on page 39 for the 
correct spelling of the 
submitted command, 
ensure mar rne commana 
is spelled correctly. 

Refer to "Navigation of 
the CLI Command Tree" 
on page 26. Ensure that 
the command has been 
entered at the right place 
in the CLI command tree, 
and then resubmit the 
command. 


Error 236: Ambiquous 
Command 


The CLI does not 
recognize the submitted 
command issued. 


The CLI cannot interpret 
the command because a 
unique match cannot be 
identified. For the 
appropriate syntax, see 
the section of the manual 
that corresponds to the 
attempted command. 
Enter the complete 
command and resubmit. 


Error 237: Invalid Zoning 
Database 


An unidentifiable 
problem with the zone set 
in the local work area 
occurred. 


Check that all the 
parameters of the 
command are valid, and 
resubmit the command. If 
the problem persists, 
clear and then reconstruct 
the zone set. 
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Message 


Description 


Action 


Error 238: Invalid 
Feature Key 


The specified feature key 
is invalid. 


Check that the feature key 
is entered correctly, and 
resubmit the command. If 
the problem persists, 
contact your service 
representative. 

The message that is 
returned is a string that 
includes both the error 
number and the text of 
the message. 


Error 239: Fabric binding 
entry not found 


The user requested to 
remove a fabric binding 
entry that is not in the 
pending Fabric 
Membership List. 


Verify that the correct 
entry (both WWN and 
Domain ID) is being 
requested for removal 
from the list and 
re-submit the request. 


Error 240: Duplicate 
fabric binding member 


The user requested to add 
an entry to the Fabric 
Binding List that is 
already a member of the 
list. 


Verify that the correct 
entry (both WWN and 
Domain ID) is being 
requested for addition to 
the list and re-submit the 
request. 


Error 241: 

Comma-delimited mode 
must be active 


Comma-delimited mode 
must be active to execute 
this command. 


Some commands require 
that comma-delimited 
mode be active (for 
example, 

show.nameServerExt. 
Enable comma-delimited 
mode and re-issue the 
command. 


Error 242: Open trunking 
threshold % value must be 
0-99 


An invalid threshold 
percentage has been 
entered. 


The Open trunking 
threshold must be in the 
range 0-99. Make sure 
all values are valid and 
resubmit the request. 


Error 243: Not allowed 
while S/390 Mode is 
Enabled 


This operation is not 
allowed while S/390 
mode (FICON 
management style in 
HAFM) is enabled. 


This command is not valid 
for the S/390 
environment (FICON 
management style in 
HAFM). 
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Table 6: CLI Error Messages (Continued) 



Message 


Description 


Action 


Error 244: Not allowed 
while Enterprise Fabric 
Mode is Active and 
Switch is Online 


This operation is not 
allowed while the switch 
is in enterprise Fabric 
mode and the switch is 

online. 


Make sure Enterprise 
Fabric mode is not 

LI J 1 iL *i L • 

enabled and the switch is 

offline. 


Error 245: Invalid 
increment value 


The increment value 
specified is not between 1 
and 70560. 


Make sure the increment 
value given is between 1 
and 70560. 


Error 246: Invalid interval 
value 


The interval value 
specified is not between 5 
and 70560 minutes. 


Make sure the increment 
value given is between 5 
and 70560 minutes. 


Error 247: Invalid counter 
number 


The counter specified is 
not a valid number. 


Use the table shown by 
the command 

perf . counterThresh 
Alerts . showStatist 
icsTable to find a 
valid counter value. 


Error 248: A counter 
must be assigned to this 
threshold alert 


A counter must be 
assigned to an alert 
before it is enabled. 


Use the 

perf . counterThresh 
Alerts . setCounter 
command to set a counter 
before the alert is 
enabled. 


Error 249: At least one 
port or port type must be 
added to this threshold 
alert 


A port or port type must 
be assigned to an alert 
before it is enabled. 


Use the 

perf . counterThresh 
Alerts . addPort 
command to add a port 

L £ iL 1 i • 

betore the alert is 
enabled. 


Error 250: Invalid counter 
threshold alert name. 


The name specified for 
the alert is not valid. 


A counter threshold alert 
with the specified name 
does not exist. 


Error 251 : The threshold 
alert must be disabled 


The counter threshold 
alert to be 
modified/deleted is 
already enabled. 


Disable the threshold 
alert and then try the 
command again. 


Error 252: Not Allowed 
While the Pending Fabric 
Binding State is Set to 
Inactive 


The pending fabric 
binding set must be set to 
Restrict in order to 
edit the pending Fabric 
Binding List. 


Set the pending fabric 
binding state to 

Restrict. 
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Message 


Description 


Action 


Error 253: Cannot 
Remove a Member 

/— ,1 1 , •,! 

Currently Interacting with 
the Fabric 


Current members of the 
fabric must be included in 

i.l c 1 * n * 1 * i * j. 

the rabric Binding List. 


Do not remove active 
fabric members from the 

I* n L • d • J* 

pending rabric Binding 
List. 


error 254: A utilization 
type must be assigned to 
this threshold alert 


A J_*l* 1* L 1 1 

A utilization type must be 
set before activating this 
threshold alert. 


All ±- i 

Add a utilization type 
and then the threshold 
alert can be activated. 


r~ O E" E" I 1*1 

error 255: Invalid 
throughput threshold alert 
name 


~rl f ±1 ±1 III 

1 he name ot the threshold 
alert is incorrect. 


r-il ±1 1 i 

cither the name does not 
exist, or the new name 
cannot be used because it 
is illegal or a duplicate. 


Error 256: Invalid 
utilization type number 


The utilization type 
number does not exist. 


Select a valid utilization 
type number. 


Error 257: Invalid 
utilization percentage 
value 


The utilization percentage 
value is out of range. 


Select a valid utilization 
percentage value. 


Error 258: Invalid 
duration value 


The duration value in 
minutes is out of range. 


Select a valid duration 
value. 


r~ a ro I 1*1 

Error 259: Invalid 
threshold alert name 


~rl f ±1 ±1 III 

1 he name ot the threshold 
alert is incorrect. 


~rl ±1 1 1 1 1 l 

Ihe threshold alert name 
does not exist. 


Error 260: Not Allowed 

1*1 f* » Mi *i f l 

while bANtegrity feature 
is not installed on any 
remote switch 


All switches in the fabric 

if 1 1 C A k 1 i * i 

must have the bANtegrity 
feature key installed. 


Install the SANteqrity 

III IT 

feature key on all 
switches in the fabric. 


Error 261: No Attached 
Members Exist 


There are no members 

11 _ L _ _J i _ il_ _ _ . . ' i _ L. 

attached to the switch. 


Check all connections 
and make sure attached 
devices are present 


Error 262: All Attached 
Members are in the 
Membership List 


All attached fabric 
members are already in 
the membership list. 


This action is redundant, 
all members are already 
in the list. 


Error 263: The 
SANtegrity 

Authentication feature 
key is not installed 


The SANtegrity 
Authentication feature 
key is not installed. 


Install the SANtegrity 
Authentication feature 
key. 
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Message 


Description 


Action 


Error 264: The Preferred 
Path feature key is not 
installed 


The preferred path 

t i.' i , ' 1 1 

feature key must Pe 

installed. 


Install the preferred path 
feature key. 


Error 265: Duplicate 
threshold alert name 


The desired name for the 
threshold alert is already 
in use. 


Use a different name for 
the threshold alert. 


Error 266: Attached 
members cannot be 
added while fabric is 
building 


Attached members 
cannot be added while 
the fabric is building. 


The fabric is still building, 
wait a couple of seconds 
until it is complete. 
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